异步检测结果回调

回调接口概述

针对于图片审核服务异步接口 .../check/asyn 和 .../batchCheck/async 的回调，用于将异步检测审核结果推送给客户，客户需要按照以下规范实现接收结果的接口。

接口说明

结果将以taskId为维度，将审核结果推送给客户。回调功能有2种配置方式：

• 方式1：请在控制台-服务配置配置回调URL（http协议），回调区域，回调密钥在配置完回调参数后自动生成。
• 方式2：在通过异步接口提交任务时，携带对应的回调参数。见图片异步检测接口说明。

需要注意使用方式2的优先级大于方式1，如在提交任务时使用接口入参方式会使控制台配置的回调参数失效，请确保入参正确。另外在接口入参时需保证回调url、回调密钥不为空，否则回调不生效。 客户方需保证回调接收接口的可用性和稳定性，确保能正常接收推送过来的结果数据。

接口鉴权

客户可通过配置完回调参数后分配的密钥信息字段进行接口鉴权。具体方式如下：

• 签名算法

  1> 将接受的的请求体参数按照ASCII码表升序顺序排序。

  2> 将排序好的参数 append 成字符串。格式为：key1 + value1 +key2 + value2…

  3> 将配置完回调参数后生成的密钥 append 到 2> 步骤生成的字符串后。

  4> 将 3> 步骤生成的字符串使用 UTF-8 进行编码，使用 MD5 进行加密生成 signature 参数值，并将其放入 请求 header 中。

• 示例代码

/**
生成签名
@param secretKey 后台密钥
@param params 接口请求参数名和参数值map，不包括signature参数名
@return
 */    
public static String signature(String secretKey, Map<String, String params){

    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    StringBuilder signBuilder = new StringBuilder();
    for (String key : keys) {
      signBuilder.append(key).append(params.get(key));
    }
    signBuilder.append(secretKey);

    try {
      return DigestUtils.md5Hex(signBuilder.toString().getBytes("UTF-8"));
    } catch (UnsupportedEncodingException e) {
      // error
    }
    return null;
}

接入说明

• 协议说明：客户方需提供支持 http 协议的 post 请求方式的接口。
• 接口性能：客户需保持接口的稳定性与可靠性。
• 失败重试：我们在收到客户回调响应后，如果不符合规定的接受成功规范，则认为此次推送失败。将以规定间隔时间 10s 推送 3 次，如果第三次继续失败将不再继续推送。

请求说明

• 请求地址及方式

  名称	值
  callbackUrl	回调地址url（http协议）
  HTTP_METHOD	POST

• 请求Header

  Header	必需	类型	描述
  Content-Type	必需	String	固定值：application/json
  signature	必需	String	签名，验证请求的合法性，参照鉴权算法

• 请求参数

  参数	类型	描述
  appId	String	所属项目ID
  taskId	String	提交异步审核时，返回的任务id
  result	String	审核结果
  checkType	String	检测项目标识，图片为 image-check

• result格式

请参考同步单条检测-HTTP响应

• 请求响应

客户接口接收到我们回调的结果后，需要返回应答信息，接口响应 code 状态码为 0，当回调处理异常时，应答的 code 状态码应为 500，或者 4xx； 应答信息为json格式，字段定义如下：