Esquema de archivos de entrada y salida para el trabajo de registro de estafadores

Esquema de archivo de entrada

A continuación, se muestra el esquema del archivo de manifiesto de entrada para los trabajos de registro de estafadores:

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

nota

Todos los campos del esquema son obligatorios.

A continuación, se describe cada atributo del esquema de entrada.

• Version: versión del documento de esquema. En la actualidad tiene que ser 1.0.

• FraudsterRegistrationRequests: lista de solicitudes de registro de estafadores que deben procesarse como parte del trabajo.

  • RequestId: un identificador para esta solicitud de registro de estafador. Debe ser único en el archivo de entrada. Se utiliza para asignar e identificar las entradas del archivo de salida.

  • AudioSpecifications: la lista de archivos de audio que Voice ID puede utilizar para registrar a este estafador. Voice ID utiliza estos archivos de audio juntos para recopilar la cantidad de voz necesaria para el registro. Actualmente, la cantidad máxima de archivos de audio permitida para una solicitud de registro es de 10. Cada archivo puede ser un archivo.wav de hasta 20 MB y contener audio con una frecuencia de muestreo del 8 y una codificación de -16. KHz PCM

    • S3URI: la ubicación de Amazon S3 del archivo de audio en formato .wav que utilizarse usarse para registrar al estafador.

    • ChannelId: el canal de audio que se utilizará para registrar al estafador en un archivo de audio multicanal. Voice ID admite archivos de audio de hasta dos canales, por lo que este valor se limita a 0 o 1.

Esquema de archivo de salida

A continuación, se muestra el esquema del archivo de manifiesto de salida para los trabajos de registro de estafadores:

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

A continuación, se describe cada atributo del esquema de salida.

• Version: versión del documento de esquema de salida. En la actualidad tiene que ser 1.0.

• Errors: la lista de errores de las solicitudes de registro de estafadores que han generado un error en algún momento del registro.

• • RequestId: el identificador de solicitud asociado a esta solicitud. Es el mismo que el RequestId especificado en el archivo de entrada de esta solicitud.

  • ErrorCode: El código de HTTP error que representa el tipo de error. A continuación, se describen algunos ejemplos de escenarios de error.

    nota

    No es una lista exhaustiva.

    • 400 (excepción de solicitud incorrecta):

      • El JSON archivo de entrada tiene un formato incorrecto y no se puede analizar.

      • Los archivos de audio proporcionados no tienen suficiente voz para el registro.

    • 402 ()ServiceQuotaLimitExceededException:

      • Límite de estafadores superado.

    • 500 (error interno):

      • Error interno del servidor (error inesperado en el servicio).

  • ErrorMessage: mensaje en el que se describe la causa del error de registro del estafador.

• SuccessfulRegistrations: lista de solicitudes de registro que se han realizado correctamente.

  • RequestId: el identificador de solicitud asociado a esta solicitud. Es el mismo que el RequestId especificado en el archivo de entrada de esta solicitud.

  • RegistrationStatus: estado en el que se ha registrado correctamente el estafador.

    • DUPLICATE_SKIPPED: se ha identificado al estafador como un duplicado y se ha omitido el registro.

    • NEW_FRAUDSTER: el estafador se ha registrado recientemente en el sistema.

  • GeneratedFraudsterId: el identificador generado por el servicio para el estafador que estaba registrado. En caso de que RegistrationStatus sea DUPLICATE_SKIPPED, se trata del identificador del estafador que ya se encuentra en el dominio más parecido al estafador en cuestión.

  • FraudsterSimilarityScore: campo opcional que se rellena cuando se omite el registro del estafador por tratarse de un duplicado. Esto representa la similitud del estafador en cuestión con el estafador más cercano que ya existe en el dominio.