适用于HMS 2.5.1
1.申请Accesstoken
新接口和老版本接口申请Accesstoken方式一致,请参考连接:
2.透传消息接口
2.1接口访问地址
老接口:
新接口:
https://api.push.hicloud.com/pushsend.do?nsp_ctx={"ver":"1","appId":"***"}红色部分使用的时候需要encode
2.2请求接口
老接口:
openpush.message.single_send
新接口:
openpush.message.api.send
2.3 请求参数
老接口:access_token=***&msgType=1&requestID=1_1362472787848&cacheMode=1&nsp_fmt=JSON&expire_time=2016-08-24+16%3A42%3A31&message=hello%7E%7E+you+got+a+push+message&priority=0&nsp_svc=openpush.message.single_send&nsp_ts=1472017414&deviceToken=00000000000000000000000000000000 具体字段解释请参考接入文档。 新接口:access_token=***&payload={"hps":{"msg":{"type":"1","body":"hello you get a push message "}}}&device_token_list=["00000000000000000000000000000000"]&expire_time=2017-06-07T19:46&nsp_svc=openpush.message.api.send&nsp_ts=1472020575 |
具体字段解释请参考接口文档,上面红色的的参数全部都是需要encode
2.4 返回参数
老接口:
{resultcode:0,message:success,requestid:1_136*****48}
新接口:
{"requestId":"14968***********3055","msg":"success","code":"80000000"}
3.通知栏消息接口
3.1 接口访问地址:
老接口:
新接口:
https://api.push.hicloud.com/pushsend.do?nsp_ctx={"ver":"1","appId":"***"}红色部分使用的时候需要encode
3.2请求接口
老接口:
openpush.message.ps_single_send
新接口:
openpush.message.api.send
3.3 请求参数
老接口: access_token=***&msgType=1&requestID=1_1362472787848&cacheMode=1&nsp_fmt=JSON&expire_time=2016-08-24+16%3A42%3A31&android={"notification_title":"hello","notification_content":"hello","doings":1}&priority=0&nsp_svc=openpush.message.psSingleSend&nsp_ts=1472017414&deviceToken=00000000000000000000000000000000 具体字段解释请参考接入文档。 新接口: access_token=***&payload={"hps":{"msg":{"type":3,"body":{"content":"hello","title": "hello"},"action":{"type":3,"param":{"appPkgName":"应用包名"}}}, "ext":{"customize":[{"自定义参数key1":"自定义参数value1"},{"自定义参数key2":"自定义参数value2"}]}}}&device_token_list=["目标设备1deivceToken","目标设备2deviceToken"]&expire_time=2017-06-07T19:46&nsp_svc=openpush.message.api.send&nsp_ts=1472020575 |
具体字段解释请参考接口文档,上面红色的的参数全部都是需要encode
3.4 返回参数
老接口:
{"resultcode":0,"message":"success","requestid":"14968888712886337"}
新接口:
{"requestId":"14968251829154666732","msg":"success","code":"80000000"}
4.一般错误应对方法
4.1 无效对话(invalid session)或对话过期(session timeout):
(1)at过期,请重新获取;
(2)at未经过UrlEncode;
(3)at原文中转义字符未被识别,请删除反斜杠;
4.2 参数错误(param error):
一般参数格式是否正确,注意只能对value值进行UrlEncode;
4.3 非法参数:
检测Push业务相关参数是否正确,payLoad结构体是否正确的进行UrlEncode
4.4 20203(Nopermission to send message to these tmIDs):
发送消息Url中的appId字段参数、accessToken、deviceToken参数不成套导致的;








































苏公安网备 32011402010933号