欺诈者注册工作的输入和输出文件架构

输入文件架构

以下是欺诈者注册工作的输入清单文件架构：

{
 "Version": "string",
    "FraudsterRegistrationRequests": [
       {
           "RequestId": "string",
           "AudioSpecifications": [
               {
                   "S3Uri": "string",
                   "ChannelId": number 
               }
           ] 
       }
    ]
}

注意

架构中的所有字段均为必填项。

以下是对输入架构每个属性的描述。

• Version：架构文档的版本。目前，它应该为 1.0。

• FraudsterRegistrationRequests：作为工作的一部分，要完成的欺诈者注册请求列表。

  • RequestId：此欺诈者注册请求的标识符。它在输入文件中必须唯一。它用于映射和识别输出文件中的条目。

  • AudioSpecifications：Voice ID 可用于注册该欺诈者的音频文件列表。Voice ID 使用这些音频文件来收集注册所需的语音量。目前，注册请求允许的最大音频文件数为 10。每个文件可以是最大为 20MB 的 .wav 文件，其中包含采样率为 8KHz 和 PCM-16 编码的音频。

    • S3URI：用于注册欺诈者的 .wav 格式音频文件的 Amazon S3 位置。

    • ChannelId：用于将欺诈者注册到多渠道音频文件中的音频渠道。Voice ID 支持最多包含两个渠道的音频文件，因此此值限制为 0 或 1。

输出文件架构

以下是欺诈者注册工作的输出清单文件架构：

{
 "Version": "string",
   "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulRegistrations": [
       {
          "RequestId": "string", 
          "GeneratedFraudsterId": "string", 
          "RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
          "FraudsterSimilarityScore": number
       }
   ]   
}

以下是对输出架构每个属性的描述。

• Version：输出架构文档的版本。目前，它应该为 1.0。

• Errors：注册期间某一时刻失败的欺诈者注册请求的错误列表。

• • RequestId：与此请求关联的请求标识符。这与该请求的输入文件中指定的 RequestId 相同。

  • ErrorCode：代表错误类型的 HTTP 错误代码。以下是一些错误场景示例。

    注意

    该列表并不完整。

    • 400（错误请求异常）：

      • 输入 JSON 文件格式错误，无法解析。

      • 提供的音频文件没有足够的语音进行注册。

    • 402 (ServiceQuotaLimitExceededException):

      • 超出欺诈者限制。

    • 500（内部故障）：

      • 内部服务器错误（服务端出现意外错误）。

  • ErrorMessage：描述欺诈者注册失败原因的消息。

• SuccessfulRegistrations：成功注册的请求列表。

  • RequestId：与此请求关联的请求标识符。这与该请求的输入文件中指定的 RequestId 相同。

  • RegistrationStatus：成功注册欺诈者的状态。

    • DUPLICATE_SKIPPED：欺诈者被认定为重复，因此跳过注册阶段。

    • NEW_FRAUDSTER：欺诈者是新注册到该系统的。

  • GeneratedFraudsterId：已注册欺诈者的服务生成的标识符。如果 RegistrationStatus 是 DUPLICATE_SKIPPED，则这是与给定欺诈者最接近的域中已存在欺诈者的标识符。

  • FraudsterSimilarityScore：一个可选字段，当欺诈者注册由于重复而被跳过时，填充该字段。这表示给定的欺诈者与域中已存在的最接近的匹配欺诈者的相似程度。