更新時間:2017-01-18 11:46:21 下載量:
1. GET提交國際短信接口示例
http://api.isms.wx96.com/webservice/isms.php?method=Submit&account=用戶名&password=APIKEY&mobile=手機號碼&content=Your verification code is 1125
注:請將1125替換成4-6位數字,建議每次發送用不同的數字。APIKEY可以登錄用戶中心查看
http://api.isms.wx96.com/webservice/isms.php?method=Submit
參數名稱 | 參數值描述 | 是否必填 |
account | 賬戶名(例如:cf_demo123) | 是 |
password | 1、APIKEY(32位字符串,可以登錄用戶中心查看) 2、動態密碼(生成動態密碼方式請看該文檔末尾的說明) |
是 |
mobile | 接收手機號碼, 只能提交一個號碼。(格式為:國家號+空格+手機號) | 是 |
content | 短信內容 | 是 |
time | Unix時間戳(10位整型數字,當使用動態密碼方式時為必填) | 否 |
format | 返回格式(可選值為:xml或json,系統默認為xml) | 否 |
用戶通過http提交發送短信請求到服務器后,服務器會返回一串xml格式的字符串,結構說明如下:
參數名稱 | 類型 | 描述 |
code | int | 返回值為2時,表示提交成功 |
smsid | string | 當提交成功后,此字段為流水號,否則為0 |
msg | string | 提交結果描述 |
2
提交成功 60495654
405
用戶名或密碼不正確 0
code | msg |
0 | 提交失敗 |
2 | 提交成功 |
400 | 非法ip訪問 |
401 | 帳號不能為空 |
402 | 密碼不能為空 |
403 | 手機號碼不能為空 |
4030 | 手機號碼已被列入黑名單 |
404 | 短信內容不能為空 |
405 | 用戶名或密碼不正確 |
4050 | 賬號被凍結 |
4051 | 剩余條數不足 |
4052 | 訪問ip與備案ip不符 |
406 | 手機格式或國家號不正確,正確格式為:國家號+空格+手機號 |
407 | 短信內容含有敏感字符 |
4071 | 沒有提交備案模板 |
4072 | 你提交過來的短信內容必須與報備過的模板格式相匹配 |
40722 | 變量內容超過指的的長度 |
4073 | 短信內容超出長度限制 |
408 | 您的帳戶疑被惡意利用,已被自動凍結,如有疑問請與客服聯系。 |
注意:因運營商規則變化,如有返回值在上述表格中找不到,請咨詢您的專屬客服
http://api.isms.wx96.com/webservice/isms.php?method=GetNum&account=用戶名&password=APIKEY
http://api.isms.wx96.com/webservice/isms.php?method=GetNum
參數名稱 | 參數值描述 | 是否必填 |
account | 賬戶名(例如:cf_demo123) | 是 |
password | 1、APIKEY(32位字符串,可以登錄用戶中心查看) 2、動態密碼(生成動態密碼方式請看該文檔末尾的說明) |
是 |
time | Unix時間戳(10位整型數字,當使用動態密碼方式時為必填) | 否 |
format | 返回格式(可選值為:xml或json,系統默認為xml) | 否 |
用戶通過http提交帳戶余額查詢請求到服務器后,服務器會返回一串xml格式的字符串,結構說明如下:
參數名稱 | 類型 | 描述 |
code | int | 狀態返回值 |
msg | string | 查詢結果描述 |
num | string | 剩余數量(單位:分) |
2
查詢成功 5002
405
用戶名或密碼不正確 0
code | msg |
2 | 查詢成功 |
400 | 非法ip訪問 |
401 | 帳號不能為空 |
402 | 密碼不能為空 |
405 | 用戶名或密碼不正確 |
4050 | 賬號被凍結 |
這里以PHP為例:
提交短信的生成方式:
$time=time(); $password=md5($account.$apikey.$mobile.$content.$time);
例如:
帳號:cf_test APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d 手機號:138xxxxxxxx 內容:Your verification code is 1125 time:1451544941 結果:$password=md5('cf_test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxxYour verification code is 11251451544941');
查詢剩余條數的生成方式:
$time=time(); $password=md5($account.$apikey.$time);
例如:
帳號:cf_test APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d 手機號:138xxxxxxxx time:1451544941 結果:$password=md5('cf_test1q784322ba1d9bb88d50cf5cdfd89k7d1451544941');
Unix時間戳參考地址:http://tool.chinaz.com/Tools/unixtime.aspx