注意事项
接口规范
- 基础地址:http://ip:port/ (ip 和 port 开账号时候会提供)
- 接口调用字符编码统一使用UTF-8,返回值JSON格式。
- 接口统一请求Content-Type为application/x-www-form-urlencoded
- md5password 是32位小写
- 客户需要报备绑定来源服务器IP,提高帐户安全性。
内容规范
- 内容最大支持800字符,支持所有UTF8字符;
- 使用POST提交,不可放到URL参数中;
- 如果一定要放到URL中,使用encodeURIComponent编码,否则 #&?%等字符会让URL不可识别;
- 内容以“【”开头,否则会因为无法找到签名而返回错误;
- 签名最大长度20,不可包含换行等特殊字符。
短信签名
每条短信都需要有签名,没有签名的短信会被拦截掉,短信签名需要中括号包起来,中英文都可。
短信示例: 【淘宝】验证码3214,五分钟之内有效。
短信签名: 淘宝
短信内容: 验证码3214,五分钟之内有效。
签名说明
- 签名长度不能超过20,否则会因为无法解析到签名而加上默认签名
- 加上默认签名后,可能会产生额外条数计费,实际以线上线下报表为准
CMPP长短信提交状态
考虑到性能影响,cmpp长短信状态,会在最后一个分片组合完成后返回提交状态,其他分片均返回0,即 一条cmpp长短信的提交状态应在所有的分片都返回0时才可认定为提交成功。
HTTP提交类型
http接口的方式采用post-表单格式,不是json格式,若是按json格式提交的,会报1001-userId不能为空 的错误。
HTTP状态,上行主动推送格式(限主动提供接口接收的http客户)
推送格式为json格式的字符串。 注意处理完之后直接返0就行,不是json格式!!!
HTTP接口加密形式
http只需要对密码进行MD5加密就可以,不需要加密其他参数。
Emoji表情符
emoji表情符四个字节,算两个字符。
CMPP提交反馈和状态记录到达顺序
运营商cmpp的submitresp可能会迟于状态(deliver)的到达时间,不一定是提交反馈(submitresp)先到达,我们平台是透传的,所以用cmpp协议要注意会出现这种情况。