接口说明：客户接口部分提供http url方式的接口，根据客户需求可以提供相应接口，接口编码方式采用统一的UTF-8

第一章 发送接口

1.1 请求地址

请求地址是客户接口程序调用时请求的url地址，采用的是http post 接口，地址是

http://115.28.172.169:8888/sms.aspx 对应UTF-8

http://115.28.172.169:8888/smsGBK.aspx 对应GB2312

入口地址一般不会发生变化，当发生变化的时候，会通知接口用户

1.2参数说明

http://115.28.172.169:8888/sms.aspx

http://115.28.172.169:8888/smsGBK.aspx

参数名称	含义	说明
userid	企业id	企业ID
account	发送用户帐号	用户帐号，由系统管理员
password	发送帐号密码	用户账号对应的密码
mobile	全部被叫号码	发信发送的目的号码.多个号码之间用半角逗号隔开
content	发送内容	短信的内容，内容需要UTF-8编码
sendTime	定时发送时间	为空表示立即发送，定时发送格式2010-         10-24 09:08:10
action	发送任务命令	设置为固定的:send
extno	扩展子号	请先询问配置的通道是否支持扩展子号，如果不支持，请填空。子号只能为数字，且最多5位数。

例如：

action=send&userid=12&account=账号&password=密码&mobile=15023239810,13527576163&content=内容&sendTime=&extno=

注：短信内容格式：【签名】+短信内容，例如：【硕达通】您本次的验证码是：2734

短信切不可用不正规内容随便测试，例如，您好，测试；哈哈哈哈；测试测试 等内容！

1.3返回值

在接收到客户端发送的http请求后，返回以xml的方式返回处理结果。格式为：

status ---------- 返回状态值：成功返回Success 失败返回：Faild

message ---------- 返回信息：见下表

remainpoint ---------- 返回余额

taskID  ----------- 返回本次任务的序列ID

successCounts --成功短信数：当成功后返回提交成功短信数

返回信息提示	说明
ok	提交成功
用户名或密码不能为空	提交的用户名或密码为空
发送内容包含sql注入字符	包含sql注入字符
用户名或密码错误	表示用户名或密码错误
短信号码不能为空	提交的被叫号码为空
短信内容不能为空	发送内容为空
包含非法字符：	表示检查到不允许发送的非法字符
对不起，您当前要发送的量大于您当前余额	当支付方式为预付费是，检查到账户余额不足
其他错误	其他数据库操作方面的错误

106短信接口备注：接口返回成功不代表接收成功，具体接收状态只能由运营商查询；运营商限制同1个号码同1个签名的内容1分钟内只能接收1条，1小时内只能接收5条，一天最多接收20条，否则可能会被运营商屏蔽，短信api接口本身不限制发送频率，具体发送频率需自行设置。

第二章 状态报告接口

2.1 请求地址

请求地址是客户接口程序调用的时候请求的url地址，采用的是http post接口，地址是

http://115.28.172.169:8888/statusApi.aspx

入口地址一般不会发生变化，当发生变化的时候，会通知接口用户

2.2参数说明

参数名称	含义	说明
userid	企业id	企业ID
account	用户帐号	用户帐号，由系统管理员
password	帐号密码	用户账号对应的密码
action	任务名称	设置为固定的：query

例如：

action=query&userid=12&account=账号&password=密码

2.3返回值

15023239810-------------对应的手机号码

1212-------------同一批任务ID

10---------状态报告----10：发送成功，20：发送失败

2011-12-02 22:12:11-------------接收时间

DELIVRD-上级网关返回值，不同网关返回值不同，仅作为参考

15023239811

1212

20

2011-12-02 22:12:11

2

2.4错误返回值——状态报告请求错误返回格式及对应值

1-------------错误码

用户名或密码不能为空-------------错误描述

1：用户名或密码不能为空

2：用户名或密码错误

3：该用户不允许查看状态报告

4：参数不正确

第三章 上行接口

3.1 请求地址

请求地址是客户接口程序调用的时候请求的url地址，采用的是http post接口，地址是

http://115.28.172.169:8888/callApi.aspx

入口地址一般不会发生变化，当发生变化的时候，会通知接口用户

3.2参数说明

参数名称	含义	说明
userid	企业id	企业ID
account	用户帐号	用户帐号，由系统管理员
password	帐号密码	用户账号对应的密码
action	任务名称	设置为固定的：query

例如：

action=query&userid=12&account=账号&password=密码

3.3返回值

<callbox>

15023239810-------------对应的手机号码

1212-------------同一批任务ID

<content>你好，我不需要content>---------上行内容

2011-12-02 22:12:11-------------接收时间

callbox>

<callbox>

15023239811

1212

<content>你好，本次活动路线是怎么的content>

2011-12-02 22:12:11

callbox>

3.4错误返回值——回复请求错误返回格式及对应值

1-------------错误码

用户名或密码不能为空-------------错误描述

1：用户名或密码不能为空

2：用户名或密码错误

3：该用户不允许查看状态报告

4：参数不正确