banner

EMA HTTP 接口协议

EMA HTTP接口文档

v3.0

一、工作方式

双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容即通过HTTPGET/POST方式交换。 

  另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名密码的方式。 

二、字符编码

服务器接收数据可以是GBK或UTF-8编码字符,默认接收据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8。
请求响应返回内容GBK编码

三、响应格式

所为响应即每次向服务器提交请求后返回值

响应值格式为纯文本
状态码

如发送成功后返回
100

四、短信发送

GET/POST操作格式: 

http://202.85.221.42:9885/c123/sendsms?uid=用户账号&pwd=MD532密码&mobile=号码&content=内容

接口参数说明:

参数名

参数字段

参数说明

uid

用户账号


pwd

用户密码

小写32位MD5加密

encode

字符编码

可选项,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8

taskid

任务ID

可选,如果不需要接收状态报告,可以不填写此参数。此参数和获取状态时返回的taskid对应,

tasked 必须是数字,范围:0-999999999

extnum

子号

扩展的长号码,只能在平台为客户分配的子号码上扩展

mobile

接收号码

同时发送给多个号码时,号码之间用英文半角逗号分隔(,)如:13972827282,13072827282,02185418874

GET  方式每次最多可以提交50条号码

POST 方式每次最多可以提交2000条号码[建议用POST方式提交]

content

短信内容

发送内容需要进行URL字符标准化转码。
  {URL字符编码说明:返回字符串,此字符串中除了
-_.之外的所有非字母数字字符都将被替换成百分号(%)后跟两位十六进制数,空格则编码为加号(+)}

ASP:server.URLEncode("短信内容")

PHP:urlencode("短信内容")

JAVA:java.net.URLEncoder.encode("短信内容")

:

号:13900008888,13900009999,13100006666

发送内容:

http://202.85.221.42:9885/c123/sendsms?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&extnum=112&mobile=13900008888,13900009999,13100006666,0218882228&content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4

发成功时响应状态码值:

100
返回发送的状态码

状态码     说明

100         发送成功

101         验证失败

102         短信不足

103         操作失败

104         非法字符

105         内容过多

106         号码过多

107         频率过快

108         号码内容空

109         账号冻结

110         禁止频繁单条发送

111         系统暂定发送

112         子号不正确

120         系统升级

五、接收回复短信

GET操作的格式: 

http://202.85.221.42:9885/c123/recvsms?uid=用户账号&pwd=MD532密码

接口参数说明:

参数

参数字段名

说明

uid

用户账号


pwd

用户密码

小写32位MD5加密


:

http://202.85.221.42:9885/c123/recvsms?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d

响应结果为纯文本,每次可接收多条回复信息:

状态码{&}回复号码||回复内容||子号 {&}回复号码||回复内容||子号

响应结果值:

100{&}13912341234||测试回复||123{&}15912343333||测试回复2||123

状态码     说明

100         接收成功

101         验证失败

六、获取状态报告

GET操作格式: 

http://202.85.221.42:9885/c123/statusreport?uid=用户账号&pwd=MD532密码

接口参数说明:

参数

参数字段名

说明

uid

用户账号


pwd

用户密码

小写32位MD5加密


:

http://202.85.221.42:9885/c123/statusreport/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d

响应结果为纯文本:

状态码{&}任务ID||手机号||消息状态||错误码{&}任务ID||手机号||消息状态||错误码

响应结果值:

100{&}10000||13912345678||0||DELIVRD

消息状态    说明
0          
成功

1           失败 

状态码     说明

100         请求成功

101         验证失败

七、查询余额

GET操作格式: 

http://202.85.221.42:9885/c123/querymoney?uid=用户账号&pwd=MD532密码

接口参数说明:

参数

参数字段名

说明

uid

用户账号


pwd

用户密码

小写32位MD5加密


:

http://202.85.221.42:9885/c123/querymoney?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d

响应结果为纯文本:

状态码{&}账户余额

账户余额单位是:元。

响应结果值:

100{&}118.5

状态码     说明

100         请求成功

101         验证失败

附EMA HTTP 接口协议下载:

EMA HTTP 接口协议.doc


阅读: 4983
本文由中文短信网原创,转载请保留链接!
中文短信网
https://www.zhsms.com/interface/28.html

留言评论

暂无留言