《创瑞---平台接口说明》由会员分享,可在线阅读,更多相关《创瑞---平台接口说明(10页珍藏版)》请在金锄头文库上搜索。
1、1短信平台接口说明Version 1.12目录1 普通短信发送 .41.1 短信提交地址 .41.2 参数定义 .41.3 短信提交响应 .41.3.1 格式说明 .51.3.2 示例 .51.3.3 响应状态值说明 .51.4 短信发送例子 .62 个性短信发送 .62.1 短信提交地址 .62.2 参数定义 .62.3 短信提交响应 .72.3.1 格式说明 .72.3.2 示例 .73 状态报告推送 .73.1 参数定义 .83.2 状态报告值 .83.3 示例 .84 短信接收 .94.1 参数定义 .94.2 示例 .95 余额查询接口 .95.1 接口地址 .95.2 参数定义 .
2、95.3 提交响应 .105.4 提交响应值 .105.5 示例 .103版本修订历史项目 日期 修订内容 备注1 2012-10-21技术支持: 邴立运 qq:613953603 手机:186575545294本文档主要定了短信平台对用户开放的主要接口和定义。1 普通短信发送用户通过 HTTP 的 POST 方式提交短信发送请求。编码采用 UTF-8编码。1.1短信提交地址URL 地址为:http:/ 参数 说明1 name 必填参数。用户账号2 pwd 必填参数。 (web 平台:基本资料中的接口密码)3 content 必填参数。发送内容(1-500 个汉字)UTF-8 编码4 mobi
3、le 必填参数。手机号码。多个以英文逗号隔开5 stime 可选参数。发送时间,填写时已填写的时间发送,不填时为当前时间发送6 sign 可选参数。用户签名。7 type 必填参数。固定值 pt8 extno 可选参数,扩展码,用户定义扩展码,只能为数字1.3短信提交响应用户短信通过 http 请求提交到服务器后,服务器返回响应码,响应码的格式如下:code,sendid,invalidcount,successcount,blackcount,msg51.3.1格式说明短信提交响应为英文逗号隔开的一行数据,状态,发送编号,无效号码数,成功提交数,黑名单数和消息,无论发送的号码是多少,一个发送
4、请求只返回一个 sendid,如果响应的状态不是“0”,则只有状态和消息(提交失败的原因) ,并将提交的参数及值原样返回。1.3.2示例 提交成功20130821110353234137876543 为返回的 sendid,这个工状态报告匹配时使用。 提交失败本示例表明用户提交失败,返回错误码为 1,服务器端并未返回 sendid 等。提交失败时是英文逗号隔开的三个参数。但是最后一个参数可能也会有英文逗号,比如发送的内容中有。这样就会有多于 3个英文逗号,请做好相应处理。0, 20130821110353234137876543,0,500,0,提交成功1,含有敏感词汇,?name=*&pwd
5、=* 等参数和值61.3.3响应状态值说明代码 说明0 提交成功1 含有敏感词汇2 余额不足3 没有号码4 包含 sql 语句10 账号不存在11 账号注销12 账号停用13 IP 鉴权失败14 格式错误-1 系统异常1.4短信发送例子http:/ 8:20:23&sign=testsign&type=pt&extno=2 个性短信发送2.1短信提交地址URL 地址为:http:/ 参数 说明1 name 必填参数。用户账号2 pwd 必填参数。 (web 平台:基本资料中的接口密码)3 content 必填参数。发送内容 UTF-8 编码,建议每次 1000 个格式:内容#号码#内容#号码7例:你好张三#13566666666#你好李四#139999999994 stime 可选参数。发送时间,填写时已填写的时间发送,不填时为当前时间发送5 s