短信發送接口 開發文檔



短信接口說明

自定義短信發送內容,適合:驗證碼、訂單短信、監控提醒、會員群發通知、會員營銷群發等。

接口支持中國移動中國聯通中國電信的全國范圍手機號碼。


 

接口地址
http://api.qirui.com:7891/mt

 

請求示例

GET 或 POST

http://api.qirui.com:7891/mt?dc=8&un=2288**0010&pw=ae2600e9456f5b0b3abc&sm=【啟瑞云】您的驗證碼是:1234&da=19788888888&tf=3&rf=2

接口參數
名稱 類型 是否必須 示例值 描述
un String 2288**0010 啟瑞云接口短信的APIKey,登錄后臺可查詢
pw String ae2600e9456f5b0b3ab8 啟瑞云接口短信的APISecret,登錄后臺可查詢
da String 19788888888 目標手機號碼,多個以“;”分隔
sm String 【啟瑞云】您的驗證碼是:100868,3分鐘內有效。如非您本人操作,可忽略本消息。 短信內容
dc Int 8
tf Int 3 短信內容編碼:3表示utf-8。
rf Int 2 返回類型:json為2、xml為1、txt為0。
rd Int 0 狀態報告:0表示不需要、1表示需要。

 

返回結果
名稱 類型 是否必須 示例值 描述
success Bool true 結果代碼:true和false
id String 164165568624102110 短信msgid,這個值可以匹配狀態報告。
r Int 9103 提交失敗返回的錯誤碼。

 

返回示例
提交成功:
{"success": true, "id": "164165568624102110"}

提交失敗:
{"success": false, "r":"9027"}

 

錯誤代碼
代碼 結果描述 解決方案
9027 短信內容缺少簽名 短信內容一定要帶簽名,簽名放在短信內容的最前面,簽名格式:【**汽車】
9426 短信內容缺少簽名 短信內容一定要帶簽名,簽名放在短信內容的最前面,簽名格式:【**汽車】
9013 手機號碼錯誤 核對da參數是否提交,檢查要發送的手機號碼格式是否正確
9014 短信內容過長 短信內容過長,短信內容不要超過500字。建議每條短信內容字數控制在300字以內
9020 號碼段錯誤 核對手機號碼是否正確,如運營商暫未開通的號碼段194
9101 pw驗證失敗 pw參數值過期或錯誤,檢查接口短信的APISecret值填寫是否正確,或聯系客服解決
9103 un接口賬號錯誤 核對un參數,檢查接口短信的APIKey值填寫是否正確
9104 IP鑒權失敗 在合法的IP上調用接口,或將該IP添加為鑒權IP
9105 超過最大連接數 超過最大并發請求數,如短信量大請聯系客服調整流速
9401 接口賬號余額不足 請在線充值,或聯系客服
9433 同一個號碼,超過每小時最大下發條數 為了避免對手機用戶的騷擾,請避免類似下發,或聯系客服
9434 同一個號碼,超過全天最大下發條數限制 為了避免對手機用戶的騷擾,請避免類似下發,或聯系客服

 

注意事項

√ 短信簽名規范
    1)短信內容一定要帶簽名,簽名放在短信內容的最前面;
    2)簽名格式:【***】,簽名內容為三個漢字以上(包括三個);
    3)短信內容不允許雙簽名,即短信內容里只有一個“【】”。

 


4399开心农场登录