为了更安全的网络访问,华为推送服务于2022年11月30日关闭Push相关域名的TLS1.0、TLS1.1协议及规定之外的加密套件,关闭后,应用使用TLS1.2以下协议或使用规定外的加密套件将无法正常推送消息。
若您的应用访问Push相关域名使用协议是TLS1.0或TLS1.1,后续可能无法正常发送消息,请您务必升级到TLS1.2及以上版本。
调整指导请查阅《Push Kit相关域名的TLS1.0和TLS1.1协议关闭通知》,如您有任何疑问,请联系技术支持,感谢您对华为推送的支持。
| 承载协议 | HTTPS POST |
|---|---|
| 接口方向 | 开发者服务器 -> 华为Push服务器 |
| 接口URL | https://push-api.cloud.huawei.com/v1/[clientid]/topic:truncate 说明: [clientid]:OAuth2.0客户端ID(凭据),登录AppGallery Connect网站,选择“开发与服务”,在项目列表中选择对应的项目,左侧导航栏选择“项目设置”,在该页面获取。 |
| 数据格式 | 请求消息:Content-Type: application/json;charset=UTF-8 响应消息:Content-Type: application/json |
Request Header
| 参数 | 取值描述 | 样例 |
|---|---|---|
| Authorization | 通过OAuth 2.0开放鉴权(客户端模式)获取的 Access Token 或者基于服务账号生成的鉴权令牌(JSON Web Token)。 说明: Bearer后面拼接空格,再拼接获取的 Access Token或JSON Web Token。 | Bearer CF3Xl2XV6jMK*******ccUIaDg== 或 Bearer eyJr*****OiIx****.eyJh*****iJodHR**.QRod*****4Gp**** |
Request Body
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| topic | 是 | String | 您创建的主题名称,最大不能超过900个字符,字符只能为数字、字母、下划线、英文点号、英文波浪号、百分号、中文。 |
| HTTP错误码 | 描述 | 解决方法 |
|---|---|---|
| 200 | 成功。 | 不涉及。 |
| 400 | 参数错误。 | 请检查响应内容错误码并根据错误码进一步排查问题。 |
| 401 | 鉴权失败。 | 请求HTTP头中Authorization参数鉴权令牌错误。 |
| 404 | 找不到服务。 | 请检查请求URI是否正确。 |
| 500 | 服务内部错误。 | 请选择提交问题,技术支持人员会及时处理。 |
| 502 | 请求连接异常,常见于网络状况不稳定。 | 建议稍后重试,或联系技术支持解决。 |
| 业务错误码 | 描述 | 解决方法 |
|---|---|---|
| 80000000 | 成功。 | 不涉及。 |
| 80200001 | 认证错误。 | 请求HTTP头中Authorization参数鉴权令牌错误。
|
| 80200003 | Access Token 过期。 | 请求HTTP头中Authorization参数中通过OAuth 2.0开放鉴权(客户端模式)获取的 Access Token 已过期,请重新申请后重试。 |
| 80200005 | JSON Web Token 过期 | 请求HTTP头中Authorization参数中基于服务账号生成的鉴权令牌(JSON Web Token)过期,请重新生成。 |
| 80400005 | 数据处理位置未选择。 | 请为您的应用设置数据处理位置,详情请参见设置默认数据处理位置。 |
| 80400006 | 数据处理位置与实际不符合。 | 请联系技术支持。 |
| 80400007 | 没有权限保存用户数据。 | 请为你的项目开通精准推送能力。 |
| 82000007 | Topic名称非法。 | 请检查Topic参数。 |
| 82000014 | 接口调用超限。 | 接口调用超限制,每天最大调用次数为100次。 |