文档开发者中心
我的

Push服务端接口升级指南

本帖最后由 韩拉米苏 于 2017-7-11 16:47 编辑

适用于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参数不成套导致的;
点赞
收藏
5
回复
50
分享
举报
浏览99209 发布于2017-06-24 07:10未知归属地
全部评论
最多点赞
最新发布
最早发布
按照文档的说明申请 Accesstoken,类似于下面这样的格式: oauth2/v2/token?grant_type=client_credentials&client_id=12345&client_secret=bKaZ0VE3EYrXaXCdCe3d2k9few 但是华为的 push 服务器一直在报错,错误信息如下: {"error":1102,"error_description":"The request is missing a required parameter"} 不能明白是少了什么参数。 是否有人可以解答一下?
51楼回复于2018-07-19 03:46 未知归属地
接口返回的参数,为啥消息头中没有nsp_status字段呢?
50楼回复于2018-06-26 06:46 未知归属地
看不懂
49楼回复于2018-05-31 04:22 未知归属地
调用新街口返回503错误。 Android HuaWei Push Result:[503 Service Temporarily Unavailable

503 Service Temporarily Unavailable


openresty
] 这个怎么解决?
48楼回复于2018-05-24 06:35 未知归属地
我看到华为开发文档和sdk,demo代码中关于 推送消息接口, 并没有提到通过标签推送,群组推送,是没有提供吗
47楼回复于2018-03-22 02:42 未知归属地
在app关闭后,手机收到消息通知(标题是aaa,内容是BBBB,行为打开CCCCactivity),如何在点击消息后进入CCCCactivity 的时候获取消息的内容和标题呢?????????
46楼回复于2018-03-16 06:24 未知归属地
华为push功能有提供AppKey吗
45楼回复于2018-03-06 05:02 未知归属地
火柴儿女 发表于 2017-12-21 15:44
{"error":"session timeout"} 如何处理?之前是正常的

您好,由于您的问题涉及到代码,还请您加QQ群进行解决,群号:662059980,加群备注:push。
44楼回复于2017-12-21 08:02 未知归属地
{"error":"session timeout"} 如何处理?之前是正常的
43楼回复于2017-12-21 07:44 未知归属地
80000001 今天突然华为推送全部返回这个错误码,请问下这个是旧的api直接不支持了么?
42楼回复于2017-12-12 12:11 未知归属地
共5页
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。