📘 MMS API 接口文檔

版本：v2.0   |   更新日期：2026-05-21

1. 發送 MMS（Bulk SMS Send）

支持向多個全球或港澳台號碼批量提交發送自定義簡訊內容。

接口地址

請求參數 (JSON Body)

參數名	類型	必填	說明
user	String	是	API 商戶帳號
pwd	String	是	API 商戶密碼
phone	String	是	接收簡訊的手機號碼。多個號碼請用英文半形逗號 (,) 分隔，須含國際區號（如 85288888888,85299999999）。
subject	String	是	發送主題
msg	String	是	發送的簡訊文本內容。
imgfile	String	否	發送圖片（目前只支持 jpg,200K 以內），支援 http 和 https 網址
sender	String	否	簡訊發送者名稱（Sender ID / 品牌簽名），如無指定可傳空字串 ""。

請求示例 (Payload)

{
  "user": "852555555",
  "pwd": "j1iaauc4",
  "phone": "85288888888",
  "msg": "這是一條測試短信",
  "subject":"test",
  "imgfile":"http://123.123.123.123/test/aaa.jpg",
  "sender": ""
}

響應參數

參數名	類型	說明
code	String	狀態碼。1 代表提交成功，其他代碼代表失敗。
msg	String	詳細說明或錯誤原因（如：提交成功）。
list	Object	提交結果統計數據物件。
└ total	Integer	本次請求提交的手機號碼總數量。
└ success	Integer	成功進入發送隊列的條數。
└ msg_hash	String	任務唯一識別碼（批次 Hash），用於後續查詢發送狀態。

返回示例 (JSON)

{
  "msg": "提交成功",
  "code": "1",
  "list": {
    "total": 1,
    "success": 1,
    "msg_hash": "d25d1e44-91c9-4a49-921a-6f728679cb06"
  }
}