注意事项

接口规范

  • 基础地址: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协议要注意会出现这种情况。

results matching ""

    No results matching ""