回调接口概述

针对于长音频异步转录接口的回调，用于将异步转录结果推送给客户，客户需要按照以下规范实现接收结果的接口。

接口说明

结果将以 taskId 为维度，将转录结果推送给客户。如需使用回调功能， 在.../recognize/submit接口提交任务时，携带对应的回调参数。见识别submit接口。

接口鉴权

客户可通过自定义的密钥信息字段进行接口鉴权。具体方式如下：

• 签名算法

  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

• 请求头

  名称	类型	必填	说明
  Content-Type	String	是	固定值：application/json
  signature	String	是	签名，验证请求的合法性，参照鉴权算法

• 请求参数

  名称	类型	说明
  appId	String	所属项目编号
  taskId	String	提交异步转录任务时，返回的任务id
  result	String	识别结果
  checkType	String	检测项目标识，语音识别 ASR

{
    "appId":"90800001",
    "taskId":"test_3840b2c4-5e58-4699-9375-8bdab03c39b5_1710140799927",
    "result":"{\"errorCode\":0,\"errorMessage\":\"OK\",\"taskId\":\"test_3840b2c4-5e58-4699-9375-8bdab03c39b5_1710140799927\",\"status\":0,\"transcripts\":[{\"startTime\":0.0,\"endTime\":5.01,\"text\":\"您好，欢迎使用云上语音识别服务。\"}],\"duration\":19010,\"languageCode\":\"zh-CN\"}",
    "checkType":"ASR",
    "userId":"12345678"
}

• 转录结果回调中result字段结构参考

识别结果查询接口

• 请求响应

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

  名称	类型	必填	说明
  code	Number	是	应答code，code 值为 0 代表此次回调成功
  message	String	否	具体描述信息