上海创明网络科技有限公司http短信接口文档

《上海创明网络科技有限公司http短信接口文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、中国短信网http接口协议上海创明网络科技有限公司HTTP短信接口文档v1.0.0.252最新修改时间:2016-1-28一、工作方式2二、响应格式2三、短信发送接口2四、批量短信接口(一对一发送)4五、动态参数短信接口6六、获取发送状态9七、获取短信回复10八、获取帐户余额11九、修改接口密钥12第12页中国短信网http接口协议一、工作方式双方通过HTTP方式交互数据，第三方可以简单的”name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。交换数据统一使用UTF-8编

2、码。另外双方需要保证数据传输的完整性和安全性，每次发送请求都有响应(响应返回格式为XML)，安全验证使用32位认证密钥的方式。二、响应格式请求响应即每次向服务器提交(建议使用POST方式提交)请求后的返回值响应值格式为XML：Name为提交的接口名Result　为返回的状态码三、短信发送接口接口参数说明:参数名参数字段参数说明ac用户账号发送短信的帐号（员工编号@企业编号）authkey认证密钥32位认证密钥（大写），企业管理员可以在软件或后台管理中获取cgid

3、通道组编号使用的通道组编号，在软件或后台管理可以查看可用的通道组csid签名编号预设的企业签名编号，请使用自己企业已通过审核的签名编号c短信内容发送内容(总长度应在1000个汉字以内)要使用UTF-8格式，如果不是请先转为UTF-8字符，再进行URL字符标准化转码。{URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）}ASP：server.URLEncode("短信内容")PHP：urlencode("短信内容")JAVA

4、：java.net.URLEncoder.encode("短信内容")m发送号码手机号码，如多个以英文逗号分隔（建议1000个及以内的手机号码，,超过系统上限将会返回参数错误）。如:15102110086,151****0086填写多个手机号码即支持了短信群发。t发送时间可选参数，无则立即发送，有则须在当前时间的一分钟之后，否则返回参数错误。格式:yyyyMMddHHmmss如:20130721182038例:第12页中国短信网http接口协议http://smsapi.c123.cn/OpenPlatform/

5、OpenApi?action=sendOnce&ac=1001@500008880001&authkey=87B01469201D6557C2685137EB3B5DEC&cgid=80&csid=101&c=%E6%B5%8B%E8%AF%95&m=15102110086,151****0086成功时返回响应:

6、>失败时返回响应：返回参数说明:参数名参数字段参数说明cid企业编号发送短信的企业编号sid员工编号发送短信的员工编号msgid发送编号每次发送的消息编号total短信条数任务需要的短信条数price单价任务中每条短信的价格remain余额本次发送后企业的帐户余额返回状态码说明：参数名参数说明1操作成功0帐户格式不正确(正确的格式为:员工编号@企业编号)-1服务器拒绝(速度过快、限时或绑定IP不对等)如遇速度过快可延时再发-2密钥不正确-

7、3密钥已锁定-4参数不正确(内容和号码不能为空，手机号码数过多，发送时间错误等)-5无此帐户-6帐户已锁定或已过期-7帐户未开启接口发送-8不可使用该通道组-9帐户余额不足-10内部错误-11扣费失败第12页中国短信网http接口协议一、批量短信接口(一对一发送)批量发送短信接口也称一对一发送接口，用于一个手机号码对应一个发送内容的批量提交。每个号码和内容都不能为空，使用批量发送需要提交短信至少为2条，最多可以一次提交100个一对一短信。也可以定时发送一对一短信，只需要指定一个要发送的时间(要在当前时间的一分钟以

8、后)即可。提交成功将返回每条短信的计费条数和发送以后的余额。要注意批量短信是按一次发送的总条数计费，请保证帐户余额足够发送当次批量短信。如果帐户余额不足将会返回失败。接口参数说明:参数名参数字段参数说明ac用户账号发送短信的帐号（员工编号@企业编号）authkey认证密钥32位认证密钥（大写），企业管理员可以在软件或后台管理中获取cgid通道组编号使用的通道组编号，在软件