目    录

 

1、 引言 2

1.1. 目的 2

1.2. 名称解释 2

2、 短信 3

2.1. http接口 3

2.1.1. 短信发送 3

2.1.2. 短信接收 4

2.1.3. 查询状态报告 5

2.1.4. 状态报告（主动推送） 5

2.1.5. 短信接收（主动推送） 6

 

 

附录：公共错误代码定义 10

 

1、 引言

1.1. 目的

该接口手册编写目的在于描述企业信息系统（以下简称EMS）具体的接口协议，供接口用户进行接口的对接开发。

备注：本接口默认以GBK编码，如需其他要求则提供其他地址。

1.2. 名称解释

2、 短信

2.1. http接口

2.1.1. 短信发送（MT）

功能：发送短信

地址： http://115.28.143.178:8080/sms/Send.do 

支持GET，POST

备注：建议采用post方法提交请求,采用GBK编码,可以支持单条和批量发送，发送会 绑定客户IP地址。

请求参数定义如下： 

返回结果以 字符串 格式形式返回，详细参数及示例如下：

失败返回结果样例：

result=1002&description=账号无效或未开户

成功返回结果样例：

result=1000&description=发送短信成功&smsId=1531927

GET示例(直接输入到IE浏览器地址栏中)：

http://115.28.143.178:8080/sms/Send.do?spId=123&loginName=xxxxx&password=xxxx&content=1233&mobiles=13712345678&subPort=

2.1.2. 短信接收（MO）

功能：短信接收

地址：http://115.28.143.178:8080/sms/reply.do

备注：支持GET，POST

建议采用post方法提交请求。已被取出的上行信息下次不会再重复提取，若调用接口返回上行记录数不为0，则取完可继续提取。一旦返回结果上行记录为0，则20秒后再发送上行信息提取请求，否则连续系统会返回空的信息数据。

请求参数定义如下： 

返回结果以String 字符串形式返回，详细参数及示例如下：

失败返回结果样例：

result=1001

成功返回结果样例：

result=1000&confirm_time=2014-05-13 23:44:35&id=62427&replys=1065817803903206032,13712312312,辣椒60，洗发水20,2014-04-23 12:43:32,56681;1065817803903206877,13712312312,嗯,2014-04-23 12:43:33,56682;

没有数据会返回：

result=0&confirm_time=2014-05-10 10:49:40

2.1.3. 查询状态报告

功能：查询状态报告

地址： http://115.28.143.178:8080/sms/report.do

备注：支持GET，POST

建议采用post方法提交请求。已被取出的状态报告信息下次不会再重复提取，若调用接口返回状态报告记录数不为0，则取完可继续提取。一旦返回结果状态报告记录为0，则20秒后再发送状态报告提取请求，否则否则返回空数据。

请求参数定义如下： 

返回结果以String 字符串形式返回，详细参数及示例如下：

失败返回结果样例：

result=1001

成功返回结果样例：

当回执数据为空时：

result=1000&reports=

不为空时：

result=1000&reports=11535,13712312312,0,DELIVRD,20140421105134;11798,13712312312,0,DELIVRD,20140421113041;12224,13712312312,0,DELIVRD,20140421120510;16529,13712312312,0,DELIVRD,20140422133113;

2.1.4. 推送状态报告

功能：推送状态报告

地址：http://客户提供IP地址:端口/服务名称

备注:POST 推送

以String 字符串形式推送，详细参数及示例如下：

例子：

 http://客户提供IP地址:端口/服务名称?result=1000&reports=1173496,15912312312,0,DELIVRD,

20140510003507;1163699,15912312316,0,DELIVRD,20140510003509

客户端接收成功，返回OK

2.1.5. 推送上行回复（MO）

功能：推送状态报告

备注:POST 推送

地址：http://客户提供IP地址:端口/服务名称

以String 字符串形式推送，详细参数及示例如下：

例子：

http://客户提供IP地址:端口/服务名称?  result=1000&replys=1069123123,15912312312,test,2014-05-10 10:35:02,61271;1069123124,15912312313,test1,2014-05-10 10:35:02,61272

客户端接收成功，返回OK

2.1.6. 查询余额

功能：查询余额

地址：http://115.28.143.178:8080/sms/SearchNumber.do

接口参数详细描述：  

返回结果以字符串格式形式返回，详细参数及示例如下：

失败返回结果样例：

result=1002

成功返回结果样例：

result=1000&leftover=32