目录

图片风控

为了更安全的网络访问,华为推送服务于2022年11月30日关闭Push相关域名的TLS1.0、TLS1.1协议及规定之外的加密套件,关闭后,应用使用TLS1.2以下协议或使用规定外的加密套件将无法正常推送消息。

若您的应用访问Push相关域名使用协议是TLS1.0或TLS1.1,可能无法正常发送消息,请您务必升级到TLS1.2及以上版本。

功能介绍

此接口给您提供对计划下发的图片进行风控校验的功能。

使用约束

接口最大调用频率限制单个应用每分钟60次。

本接口仅用于Push消息推送场景,不得用于其他用途。通过风控校验的图片不得修改,否则会导致通知消息无法正常显示。

接口原型

承载协议

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

  • [clientId]:OAuth 2.0客户端ID(凭据),登录AppGallery Connect网站,选择“我的项目”,在项目列表中选择对应的项目,左侧导航栏选择“项目设置”,在该页面获取。
  • [projectId]:项目ID,登录AppGallery Connect网站,选择“我的项目”,在项目列表中选择对应的项目,左侧导航栏选择“项目设置”,在该页面获取。
  • 提供的两个接口URL功能相同,只是鉴权方式不同,均可使用。

请求参数

Request Header

参数

取值描述

样例

Authorization

鉴权方式:

JWT方式

详情参见基于服务账号生成鉴权令牌。

说明:

建议JWT令牌过期时间设置为3600秒,有效期内可以复用。Bearer后面拼接空格,再拼接获取的鉴权信息。

Bearer eyJraWQiOiIx---xxx.eyJhdWQiOiJodHR---xxx.QRodgXa2xeXSt4Gp---xxx

push-type

消息类型,取值如下:

0:通知消息发送大图标消息场景

1:服务卡片刷新图片场景

2:通知扩展发送大图标消息场景

1

Request Body

参数

是否必选

参数类型

描述

imageUrl

是

String

待验证图片的公网地址,必须是https协议。

请求示例

{
    "imageUrl": "https://example.com/image.png"
}

响应参数

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是否正确。