postmen | APP开发

VIVO消息推送接入push服务注意事项

开发者接入push服务存在的共性问题排查指南：

一、请接入方先通过本地工具【postmen】先调用我们提供的接口，保证本地调用我们的接口是没有问题【减少在开发过程沟通成本】

二、如果是本地工具接口测试：请先检查一下事项

1、请先测试推送鉴权接口，获取到 authToken 才可以进行消息推送【可以确保接入方本地调用push服务是通的】

2、检查一下当前应用是否是受限应用（受限应用将在2-3个工作日内转为正式）

①如果是受限应用，则只能测试单播接口，测试其他推送接口会有对应提示

②如果是受限应用，那么需要在vivo推送营运平台后台添加要测试的设备【设备id(regId)】最多可以添加20个设备

③如果是受限应用，在调用单播接口的时候，需要在请求参数中确认pushMode==1字段（0：正式推送；1：测试推送，不填默认为0）

测试推送没有频控限制（受限应用发不了正式推送）

3、检查一下当前推送的消息是运营消息还是系统消息【前提：推送为正式推送】

（接入方在推送的时候参数 classification==0 ， 0：运营类消息，1：系统类消息。不填默认为0）

如果客户端多次收到消息后，又出现收不到的情况

检查消息是否被管控，单用户单应用每天收到的消息条数上限5条，系统消息不受应用频控管控，受系统消息推送总量限制

建议：如果只是检验功能，建议使用测试推送【测试消息不受频控、推送量级管控】

三、关于消息数据统计问题【vivo推送运营后台有相关消息统计明细分布情况】

请各个接入方先到 vivo推送管理后台查看当前应用消息大体的数据统计分布情况

统计分两种：

①应用级别的消息统计明细分布情况

②单推统计明细分布情况

【可以通过这两个指标，进一步分析消息没有达到的原因】

同时：建议接入方在关键地方也收集数据。比如消息达到客户端，建议应用方也做一个记录。

对我们接口返回的regId（1.userId不存在；2.卸载或者关闭了通知；3.七天不在线；4.非测试用户），这些状态也存储一下，可以预防无效的推送

四、如遇接口返回状态码 10206 sign 不正确提示【前提：一样的签名方法，偶现签名不正确】

如果出现这种情况：

就是业务方在进行签名的时候 appId/appKey/appSecret 存在本来给“应用A”生成的签名，结果把sign拿给“应用B”进行签名了

【签名：使用MD5算法，字符串trim后拼接（appId+appKey+timestamp+appSecret），然后通过MD5加密得到的值（字母小写）】

请接入方在有多个应用的时候，要注意签名方法的使用，防止签名误传

五、如遇接口返回状态码 10000 权限认证失败，则表示应用方获取的authToken 失效了，请重新获取

六、regId升级

原有token(regId)生成规则是固定23位数字。已不能满足后续增长需求，推送平台从2022年5月开始升级token(regId)生成规则，取消现有固定23位长度及数字限制，新规则长度可变，包含字符“0-9”、“a-z”、“A-Z”及特殊字符。2022年7月30号全量升级。老的regId不变，新订阅会按照新regId规则生成。

七、如何发送测试消息图解

接入Vpush后的应用均可以发送测试消息。发送测试消息的步骤如下：

1、先在推送运营后台添加测试设备。

1）在推送平台找到你的应用名称