为了更安全的网络访问,华为推送服务于2022年11月30日关闭Push相关域名的TLS1.0、TLS1.1协议及规定之外的加密套件,关闭后,应用使用TLS1.2以下协议或使用规定外的加密套件将无法正常推送消息。
若您的应用访问Push相关域名使用协议是TLS1.0或TLS1.1,可能无法正常发送消息,请您务必升级到TLS1.2及以上版本。
承载协议 | HTTPS POST |
|---|---|
接口方向 | 开发者服务器 -> 华为Push服务器 |
接口URL | https://push-api.cloud.huawei.com/v1/[clientId]/images:verify |
接口URL | https://push-api.cloud.huawei.com/v2/[projectId]/images:verify |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
参数 | 取值描述 | 样例 |
|---|---|---|
Authorization | 鉴权方式: JWT方式 详情参见基于服务账号生成鉴权令牌。 说明: 建议JWT令牌过期时间设置为3600秒,有效期内可以复用。Bearer后面拼接空格,再拼接获取的鉴权信息。 | Bearer eyJraWQiOiIx---xxx.eyJhdWQiOiJodHR---xxx.QRodgXa2xeXSt4Gp---xxx |
push-type | 消息类型,取值如下: 0:通知消息发送大图标消息场景 1:服务卡片刷新图片场景 2:通知扩展发送大图标消息场景 | 1 |
Request Body
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
imageUrl | 是 | String | 待验证图片的公网地址,必须是https协议。 |
Response Body
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
code | 是 | String | 响应码。 |
msg | 是 | String | 响应码描述。 |
requestId | 否 | String | 请求标识。 |
downloadUrl | 否 | String | 验证通过的图片地址(本接口成功时才返回)。 |
expireTime | 否 | String | 图片风控验证有效截止时间,以Unix时间戳表示,单位为“秒”(本接口成功时才返回)。 |
响应成功示例:
{
"code": "83010000",
"msg": "Verify success",
"requestId": "1631***********0101",
"downloadUrl": "https://**.png?verifyKey=MEUCIQDzfYMReU*****************fdCOX9KToGq7o%3D",
"expireTime": "1689911616"
} 响应失败示例:
{
"code": "83010005",
"msg": "Download picture failed",
"requestId": "1691***********1501"
} HTTP响应码 | 描述 | 解决方法 |
|---|---|---|
400 | 参数错误。 | 请检查业务响应码并根据业务响应码进一步排查问题。 |
401 | 鉴权失败。 | 请检查HTTP请求头中Authorization参数里面的JWT。 |
404 | 找不到服务。 | 请检查请求URI是否正确。 |
500 | 服务内部错误。 | 请通过在线提单提交问题。 |
502 | 请求连接异常,常见于网络状况不稳定。 | 建议稍后重试,或通过在线提单提交问题。 |
业务响应码 | 描述 | 解决方法 |
|---|---|---|
80100001 | 参数错误。 | 请按照响应消息中的提示,检查请求参数。 |
80100003 | url格式错误。 | 图片imageUrl必须为https协议。 |
80200001 | Oauth认证错误。 | HTTP请求头中Authorization参数里面的JWT鉴权失败,请检查JWT。 |
80200003 | Oauth Token过期。 | HTTP请求头中Authorization参数里面的JWT已过期,请重新申请后重试。 |
80200005 | JWT过期。 | Authorization参数中的JWT已过期,请重新生成后重试。 |
80300002 | 没有权益。 | 请检查发送的项目是否已经开通推送服务。 |
83010000 | 图片通过风控。 | 不涉及。 |
83010001 | 图片未通过风控。 | 图片未通过风控,请检查图片是否包含敏感信息。 |
83010002 | 超出流控阈值。 | 请降低请求频率后重试。 |
83010003 | 消息体为空。 | 请检查消息体内容是否正确。 |
83010004 | 不支持风控。 | 未匹配到风控策略,请通过在线提单提交问题。 |
83010005 | 下载图片失败。 | 图片下载失败,请检查请求体中的图片URL是否正确。 |
83010007 | 消息类型错误。 | 请检查push-type是否正确。 |