Help Center

    自定义图片名单修改接口

    2025.04.14 15:59:30

      接口说明

      通过该接口可以修改已抄送的自定义图片名单状态信息，易盾会同步刷新信息。

      鉴权说明

      易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

      请求

      请求地址

      名称 值
      HTTP URL https://as.dun.163yun.com/v1/image/list/update
      HTTP Method POST

      请求头

      名称 类型 描述
      Content-Type String 固定值："application/x-www-form-urlencoded"

      请求参数

      请求参数由公共参数和业务参数两部分组成。

      公共参数

      公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数

      业务参数

      名称 类型 是否必填 描述
      version String 是 接口版本号，值为v1
      type Integer 是 名单类型，0: 相似名单，1: md5精确名单
      uuid String 是 图片名单uuid唯一标识
      md5 String 否 图片md5，uuid和md5必须传一个，且如果只传了md5必须传businessId
      status Integer 是 名单状态，0: 未生效，1: 已生效

      请求体示例

      signature=signature&secretId=your_secret_id&businessId=your_businessId_id&nonce=16163&version=v1&timestamp=1574653947813&uuid=512e7771c3074621914ae1894e0df5c1&type=1&status=0

      响应

      响应结果

      返回通用结构：

      名称 类型 是否返回 描述
      code Integer 是 返回错误码，详细见响应公共字段
      msg String 是 返回错误消息
      result Boolean 是 提交返回结果

      响应体示例

      {
    "code": 200,
    "msg": "ok",
    "result": true
}

      示例代码

      服务端 SDK 接入

      推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 服务端 SDK 接入指引 了解更多。

      Github Demo 地址

      Gitee Demo 地址（Github 无法访问时选择）

      HTTP API 接入

      Github Demo 地址

      Gitee Demo 地址（Github 无法访问时选择）

      Comment On The Document:

      If you encounter product-related problems, you can Submit a ticket 或 Online Chat Seek help.

      Online Chat Tel：95163223 Free trial