Skema file input dan output untuk Job Registrasi Fraudster

Skema file masukan

Berikut ini adalah skema file manifes masukan untuk Pekerjaan Pendaftaran Penipu:

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

catatan

Semua bidang dalam skema diperlukan.

Berikut ini adalah deskripsi dari setiap atribut skema masukan.

• Version: Versi dokumen skema. Saat ini, ini seharusnya1.0.

• FraudsterRegistrationRequests: Daftar permintaan pendaftaran penipu yang harus dipenuhi sebagai bagian dari pekerjaan.

  • RequestId: Pengenal untuk permintaan pendaftaran penipu ini. Itu harus unik dalam file input. Ini digunakan untuk memetakan dan mengidentifikasi entri dalam file output.

  • AudioSpecifications: Daftar file audio yang dapat digunakan Voice ID untuk mendaftarkan penipu ini. ID Suara menggunakan file audio ini bersama-sama untuk mengumpulkan jumlah pidato yang diperlukan untuk pendaftaran. Saat ini, jumlah maksimum file audio yang diizinkan untuk permintaan pendaftaran adalah 10. Setiap file dapat berupa file.wav hingga 20MB, berisi audio dengan laju sampel 8kHz dan pengkodean PCM-16.

    • S3URI: Lokasi Amazon S3 dari file audio dalam format.wav yang perlu digunakan untuk mendaftarkan penipu.

    • ChannelId: Saluran audio yang akan digunakan untuk mendaftarkan penipu dalam file audio multi-saluran. ID Suara mendukung file audio hingga dua saluran, jadi nilai ini dibatasi untuk 0 atau 1.

Skema file keluaran

Berikut ini adalah skema file manifes keluaran untuk Pekerjaan Pendaftaran Penipu:

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

Berikut ini adalah deskripsi dari setiap atribut dari skema output.

• Version: Versi dokumen skema keluaran. Saat ini, ini seharusnya1.0.

• Errors: Daftar kesalahan untuk permintaan pendaftaran penipu yang gagal di beberapa titik selama pendaftaran.

• • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

  • ErrorCode: Kode kesalahan HTTP yang mewakili jenis kesalahan. Beberapa contoh skenario kesalahan dijelaskan di bawah ini.

    catatan

    Ini bukan daftar lengkap.

    • 400 (Pengecualian Permintaan Buruk):

      • File JSON masukan salah bentuk dan tidak dapat diuraikan.

      • File audio yang disediakan tidak memiliki cukup pidato untuk pendaftaran.

    • 402 (ServiceQuotaLimitExceededPengecualian):

      • Batas penipu terlampaui.

    • 500 (Kegagalan Internal):

      • Kesalahan Server Internal (Kesalahan tak terduga di sisi Layanan).

  • ErrorMessage: Pesan yang menjelaskan penyebab kegagalan pendaftaran penipu.

• SuccessfulRegistrations: Daftar permintaan pendaftaran yang berhasil.

  • RequestId: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang RequestId ditentukan dalam file input untuk permintaan ini.

  • RegistrationStatus: Status pendaftaran penipu yang berhasil.

    • DUPLICATE_SKIPPED: Penipu diidentifikasi sebagai duplikat, dan pendaftaran dilewati.

    • NEW_FRAUDSTER: Penipu baru saja terdaftar ke dalam sistem.

  • GeneratedFraudsterId: Pengenal yang dihasilkan layanan untuk penipu yang terdaftar. Dalam hal iniDUPLICATE_SKIPPED, ini adalah pengidentifikasi penipu yang sudah ada di domain yang paling cocok dengan penipu yang diberikan. RegistrationStatus

  • FraudsterSimilarityScore: Bidang opsional yang diisi saat pendaftaran penipu dilewati karena merupakan duplikat. Ini mewakili kesamaan penipu yang diberikan dengan penipu pencocokan terdekat yang sudah ada di domain.