彩信群发_日韩欧美亚洲精品_群发彩信软件_日韩欧美亚洲国产精品字幕久久久_视频短信营销平台-日韩欧美亚洲-达信通

您是否正受到短信簽名報備的困擾?達信通解決方案讓您最快15分鐘內恢復信息傳遞,馬上 注冊體驗

短信驗證碼

1、概要

1.1 文檔說明

本文檔主要提供給達信通平臺的用戶對接接口的使用說明,開發者可以利用 達信通 提供的 HTTP 接口,調用 達信通 的短信驗證碼/通知服務。

1.2 接口內容

本文檔包含短信發送、余額查詢、發送回執推送、上行回復推送等。

1.3 提交方式

GET / POST

1.4 加密方式

1、采用HTTPS協議提交請求
2、通過MD5動態簽名方式加密

1.5 API ID / API KEY

登錄用戶中心,進入【驗證碼通知短信】模塊,在【產品總攬】頁面右上角,如下圖所示:

1.6 短信模版

短信模板是對您將要發送的短信進行相似性提取后的內容。舉個例子,

A 用戶在您平臺注冊會員,需要發送一條短信,內容如下:
您好,您的驗證碼是:666666
同時,B 用戶也在您的平臺注冊會員,發送了如下短信:
您好,您的驗證碼是:888888
我們提取相似度以后,可以制作以下短信模板:
您好,您的驗證碼是:【變量】
其中,變量是可變的,可以是 數字、字母、漢字。

注意:未付費用戶僅可使用默認短信模板,付費用戶可以通過左側導航【驗證碼通知短信】 -【短信發送】-【簽名/模版管理】新增短信模板,運營商審核通過之后即可正式使用。

1.7 短信簽名

短信簽名是加在短信的開頭或結尾,在【】加上您的公司名稱或店鋪名稱的標識符,例如:【達信通】。 根據電信基礎運營商的規定,每條短信必須附加短信簽名,否則將無法正常發送。

注意:未付費用戶僅可使用默認短信簽名【達信通】,付費用戶可以通過點擊左側導航【驗證碼通知短信】-【短信發送】-【簽名/模版管理】修改簽名,運營商審核通過之后即可正式使用。

2、短信發送

2.1 接口描述

通過POST、 GET 方式進行短信提交,數據編碼采用utf-8格式,24小時全天發送。

2.2 請求地址

http://api.voice.dxtong.com/webservice/voice.php?method=Submit

2.3 請求參數

參數名稱 參數值描述 必填
account APIID(用戶中心【驗證碼通知短信】-【產品縱覽】查看)
password 1、APIKEY(用戶中心【驗證碼通知短信】-【產品縱覽】查看)
2、動態密碼(生成動態密碼方式請看該文檔末尾的說明)
mobile 接收手機號碼,只能提交1個號碼
content 短信內容(編碼格式為 UTF-8,支持 300 個字的長短信,長短信 按多條計費)
例如:您的驗證碼是:1234。請不要把驗證碼泄露給其他人。
time Unix時間戳(10位整型數字,當使用動態密碼方式時為必填)
format 返回格式(可選值為:xml或json,系統默認為xml)

用戶通過http 或 https提交發送短信請求到服務器后,服務器會返回一串xml格式的字符串,SubmitResult結構說明如下:

參數名稱 類型 描述
code int 返回值為2時,表示提交成功
smsid string 當提交成功后,此字段為流水號,否則為0
msg string 提交結果描述

2.4 響應示例

示例(成功)

  2         提交成功 14745625541233112231 

示例(失敗)

  405 用戶名或密碼不正確 0     

2.5 響應參數

code msg
0 提交失敗
2 提交成功
400 非法ip訪問
401 帳號不能為空
402 密碼不能為空
403 手機號碼不能為空
4030 手機號碼已被列入黑名單
404 短信內容不能為空
405 API ID 或 API KEY 不正確
4050 賬號被凍結
40501 動態密碼已過期
40502 動態密碼校驗失敗
4051 剩余條數不足
4052 訪問 ip 與備案 ip 不符
406 手機格式不正確
407 短信內容含有敏感字符
4070 簽名格式不正確
4071 簽名格式不正確
4072 簽名格式不正確
40722 變量內容超過指定的長度【8】
4073 短信內容超出長度限制
4074 短信內容包含 emoji 符號
4075 簽名未通過審核
408 發送超限([20]條),已加入黑名單,可登入平臺解除
4080 同一手機號碼同一秒鐘之內發送頻率不能超過 1 條
4082 超出同一手機號一天之內【5】條短信限制
4085 同一手機號驗證碼短信發送超出【5】條

2.6 請求示例

        http://106.dxtong.com/webservice/sms.php?method=Submit&account=APIID&password=APIKEY&mobile=手機號碼&content=您的驗證碼是:1234。請不要把驗證碼泄露給其他人。

3、余額查詢

3.1 接口描述

通過接口可以方便的查詢你的賬戶驗證碼通知短信剩余條數。

3.2 請求地址

        http://106.dxtong.com/webservice/sms.php?method=GetNum

3.3 請求參數

參數名稱 參數值描述 是否必填
account APIID(請登錄用戶中心【驗證碼通知短信】-【產品縱覽】查看)
password 1、APIKEY(請登錄用戶中心【驗證碼通知短信】-【產品縱覽】查看)
2、動態密碼(生成動態密碼方式請看該文檔末尾的說明)
time Unix時間戳(10位整型數字,當使用動態密碼方式時為必填)
format 返回格式(可選值為:xml或json,系統默認為xml)

用戶通過http 或 https提交帳戶余額查詢請求到服務器后,服務器會返回一串xml格式的字符串,GetNumResult結構說明如下:

參數名稱 類型 描述
code int 狀態返回值
msg string 查詢結果描述
num string 剩余數量

3.4 響應示例

示例(成功)

  2 查詢成功 856         

示例(失敗)

  405 用戶名或密碼不正確 0 

3.5 響應參數

code msg
2 查詢成功
400 非法ip訪問
401 帳號不能為空
402 密碼不能為空
405 用戶名或密碼不正確
4050 賬號被凍結

3.6 GET請求示例

        http://106.dxtong.com/webservice/sms.php?method=GetNum&account=APIID&password=APIKEY

4、發送回執推送

4.1 接口描述

用戶先提供數據接收地址,然后綁定到達信通系統后臺,平臺會以POST方式實時的將回執信息推送到此地址。

4.2 推送參數

參數名稱 參數值描述
code 狀態值(2成功 其他為失敗)
msg 回執狀態說明
mobilephone 手機號碼
smsid 流水號(對應提交時返回的smsid)
report_time 回執時間 例:2017-08-02 14:31:51

注意: 成功接收請輸出字符 “success” (不包含引號)結束推送,否則以接收失敗處理。 每個回執最多推送 3 次。每次間隔疊加 60 秒。

5、上行回復推送

5.1 接口描述

用戶先提供數據接收地址,然后綁定到達信通系統后臺,平臺會以 POST 方式實時的將 回復信息推送到此地址。

5.2 推送參數

參數名稱 參數值描述
mobilephone 手機號碼
content 上行內容
smsid 流水號(對應提交時返回的 smsid)(僅作參考)
reply_time 上行時間 例:2017-05-24 17:46:50

注意: 成功接收請輸出字符 “success” (不包含引號)結束推送,否則以接收失敗處理。每個回執最多推送 3 次。每次間隔疊加 60 秒。

6、提交模板

6.1 接口描述

通過 POST、 GET 方式提交短信模版,數據編碼采用 utf-8 格式,24 小時全天發送。

6.2 請求地址

        http://106.dxtong.com/webservice/sms.php?method=AddTemplate&account=APIID&password=APIKEY&content=您的驗證碼是:【變量】。請不要把驗證碼泄露給其他人。

6.3 請求參數

參數名稱 參數值描述
method AddTemplate
account 提交賬戶
password 提交賬戶密碼 (可以明文密碼或使用 32 位 MD5 加密)
模板內容 模板內容

返回值 AddTemplateResult 結構說明:

參數名稱 類型 描述
code int 返回值為 2 時,表示添加成功
msg string 提交狀態描述
templateid int 添加成功則返回模板 ID

6.4 響應參數

code msg
2 添加成功
400 提交狀態描述
401 添加成功則返回模板 ID
402 密碼不能為空
404 模板內容不能為空
405 用戶名或密碼不正確
4050 賬號被凍結
407 模板內容含有敏感字符

6.5 模板審核狀態推送

在遵守 HTTP 協議規范的前提下,通過 POST 方式將回執推送到用戶指定的 URL 地址。

參數說明:

參數名稱 參數值描述
code 狀態值(2 成功 0 駁回)
msg 審核狀態描述
templateid 模板 ID

注意:

1.成功接收請輸出字符 “success” (不包含引號)結束推送,否則以接收失敗處理。

2.每個回執最多推送 3 次。每次間隔疊加 60 秒。

3.code 值說明

2 成功

0 駁回(原因請看 msg 字段)

7、生成動態密碼方式

以PHP為例,提交語音驗證碼的生成方式:

$time = time();
$password = md5($account.$apikey.$mobile.$content.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手機號:138xxxxxxxx
內容:您的驗證碼是:2546。請不要把驗證碼泄露給其他人。
time:1451544941
結果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxx 您的 驗證碼是:2546。請不要把驗證碼泄露給其他人。1451544941');

注意:因為短信內容會包含中文,所以字符編碼統一為 UTF-8

查詢剩余條數的生成方式:

$time = time();
$password = md5($account.$apikey.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手機號:138xxxxxxxx
time:1451544941
結果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d1451544941');

Unix時間戳參考地址:http://tool.chinaz.com/Tools/unixtime.aspx

8、常見問題

8.1 如何處理亂碼

說明: 將短信內容( content)進行 UTF-8 編碼后提交。

PHP 亂碼:

$content = iconv("GBK","UTF-8",$content);

JAVA 亂碼:

sb.append("&content="+URLEncoder.encode(content,"UTF-8"));

C#亂碼:

byte[] bTemp = System.Text.Encoding.GetEncoding("GBK").GetBytes(sbTemp.ToString());

8.2 如何實現 UNIX 時間戳

語言 代碼
JAVA String date = new java.text.SimpleDateFormat("dd/MM/yyyy HH:mm:ss").format(new java.util.Date(Unix timestamp *1000))
Linux date -d @Unix timestamp
C strptime(datetime, "%Y-%m-%d %H:%M:%S", &tm_time); unixtime = mktime(&tm_time);
C++ std::time_t t = std::time(0);
DELPHI uses DateUtils;
DateTimeToUnix(Now)
GO import "time"
cur := time.Now()
timestamp := cur.UnixNano() / 1000000
Perl 先 my $time = Unix timestamp 然后 my ($sec, $min, $hour, $day, $month, $year) = (localtime($time))[0,1,2,3,4,5,6]
PHP date('r', Unix timestamp)
Node.js var date = new Date( time * 1000 );
var time = date.getTime()/1000;
Python 先 import time 然后 time.gmtime(Unix timestamp)
Ruby Time.at(Unix timestamp)
SHELL date +%s //UNIX 的時間戳;
VBScript / ASP DateAdd("s", Unix timestamp, "01/01/1970 00:00:00")
VB6 DateDiff("s", "1970-1-1 0:0:0", ToUnixTime)
易語言 時間_到時間戳()

 

 

在線咨詢
電話咨詢

服務熱線:

4008 808 898

服務熱線(工作時間):

4008 808 898

業務咨詢(非工作時間):

4008 808 898

售后咨詢(非工作時間):

4008 808 898

主站蜘蛛池模板: 医养体检包_公卫随访箱_慢病随访包_家签随访包_随访一体机-济南易享医疗科技有限公司 | PCB设计,PCB抄板,电路板打样,PCBA加工-深圳市宏力捷电子有限公司 | 泡沫消防车_水罐消防车_湖北江南专用特种汽车有限公司 | 根系分析仪,大米外观品质检测仪,考种仪,藻类鉴定计数仪,叶面积仪,菌落计数仪,抑菌圈测量仪,抗生素效价测定仪,植物表型仪,冠层分析仪-杭州万深检测仪器网 | 上海租车公司_上海包车_奔驰租赁_上海商务租车_上海谐焕租车 | 钢衬玻璃厂家,钢衬玻璃管道 -山东东兴扬防腐设备有限公司 | 成都办公室装修-办公室设计-写字楼装修设计-厂房装修-四川和信建筑装饰工程有限公司 | 智能楼宇-楼宇自控系统-楼宇智能化-楼宇自动化-三水智能化 | 高效复合碳源-多核碳源生产厂家-污水处理反硝化菌种一长隆科技库巴鲁 | 低浓度恒温恒湿称量系统,强光光照培养箱-上海三腾仪器有限公司 | 泰国试管婴儿_泰国第三代试管婴儿费用|成功率|医院—新生代海外医疗 | 防渗膜厂家|养殖防渗膜|水产养殖防渗膜-泰安佳路通工程材料有限公司 | 剪刃_纵剪机刀片_分条机刀片-南京雷德机械有限公司 | 合肥网络推广_合肥SEO网站优化-安徽沃龙First | 碳化硅,氮化硅,冰晶石,绢云母,氟化铝,白刚玉,棕刚玉,石墨,铝粉,铁粉,金属硅粉,金属铝粉,氧化铝粉,硅微粉,蓝晶石,红柱石,莫来石,粉煤灰,三聚磷酸钠,六偏磷酸钠,硫酸镁-皓泉新材料 | 威实软件_软件定制开发_OA_OA办公系统_OA系统_办公自动化软件 | 塑料瓶罐_食品塑料瓶_保健品塑料瓶_调味品塑料瓶–东莞市富慷塑料制品有限公司 | 贝壳粉涂料-内墙腻子-外墙腻子-山东巨野七彩贝壳漆业中心 | 江门流水线|江门工作台|江门市伟涛行工业设备有限公司 | 祝融环境-地源热泵多恒系统高新技术企业,舒适生活环境缔造者! | 掺铥光纤放大器-C/L波段光纤放大器-小信号光纤放大器-合肥脉锐光电技术有限公司 | 胶辊硫化罐_胶鞋硫化罐_硫化罐厂家-山东鑫泰鑫智能装备有限公司 意大利Frascold/富士豪压缩机_富士豪半封闭压缩机_富士豪活塞压缩机_富士豪螺杆压缩机 | 不锈钢列管式冷凝器,换热器厂家-无锡飞尔诺环境工程有限公司 | 自动钻孔机-全自动数控钻孔机生产厂家-多米(广东)智能装备有限公司 | 滚塑PE壳体-PE塑料浮球-警示PE浮筒-宁波君益塑业有限公司 | HYDAC过滤器,HYDAC滤芯,现货ATOS油泵,ATOS比例阀-东莞市广联自动化科技有限公司 | 大功率金属激光焊接机价格_不锈钢汽车配件|光纤自动激光焊接机设备-东莞市正信激光科技有限公司 定制奶茶纸杯_定制豆浆杯_广东纸杯厂_[绿保佳]一家专业生产纸杯碗的厂家 | 纸张环压仪-纸张平滑度仪-杭州纸邦自动化技术有限公司 | 自动气象站_农业气象站_超声波气象站_防爆气象站-山东万象环境科技有限公司 | 紫外线老化试验箱_uv紫外线老化试验箱价格|型号|厂家-正航仪器设备 | 西安微信朋友圈广告投放_微信朋友圈推广_西安度娘网络科技有限公司 | 注塑机-压铸机-塑料注塑机-卧式注塑机-高速注塑机-单缸注塑机厂家-广东联升精密智能装备科技有限公司 | 北京翻译公司-专业合同翻译-医学标书翻译收费标准-慕迪灵 | 江苏南京多语种翻译-专业翻译公司报价-正规商务翻译机构-南京华彦翻译服务有限公司 | PTFE接头|聚四氟乙烯螺丝|阀门|薄膜|消解罐|聚四氟乙烯球-嘉兴市方圆氟塑制品有限公司 | 刚性-柔性防水套管-橡胶伸缩接头-波纹管补偿器-启腾供水材料有限公司 | 成人纸尿裤,成人尿不湿,成人护理垫-山东康舜日用品有限公司 | 不锈钢监控杆_监控立杆厂家-廊坊耀星光电科技有限公司 | 合肥风管加工厂-安徽螺旋/不锈钢风管-通风管道加工厂家-安徽风之范 | 爱德华真空泵油/罗茨泵维修,爱发科-比其尔产品供应东莞/杭州/上海等全国各地 | 西安展台设计搭建_西安活动策划公司_西安会议会场布置_西安展厅设计西安旭阳展览展示 |