Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AnalyzeID
Menganalisis dokumen identitas untuk informasi yang relevan. Informasi ini diekstraksi dan dikembalikan sebagaiIdentityDocumentFields
, yang mencatat bidang normal dan nilai teks yang diekstraksi.Tidak seperti operasi Amazon Textract Texact lainnya,AnalyzeID
tidak mengembalikan data Geometry.
Sintaksis Permintaan
{
"DocumentPages": [
{
"Bytes": blob
,
"S3Object": {
"Bucket": "string
",
"Name": "string
",
"Version": "string
"
}
}
]
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- DocumentPages
-
Dokumen yang diteruskan ke AnalyzeID.
Jenis: ArrayDocumentobjek
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 2 item.
Diperlukan: Ya
Sintaksis Respons
{
"AnalyzeIDModelVersion": "string",
"DocumentMetadata": {
"Pages": number
},
"IdentityDocuments": [
{
"DocumentIndex": number,
"IdentityDocumentFields": [
{
"Type": {
"Confidence": number,
"NormalizedValue": {
"Value": "string",
"ValueType": "string"
},
"Text": "string"
},
"ValueDetection": {
"Confidence": number,
"NormalizedValue": {
"Value": "string",
"ValueType": "string"
},
"Text": "string"
}
}
]
}
]
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- AnalyzeIDModelVersion
-
Versi AnalyzeIdentity API yang digunakan untuk memproses dokumen.
Jenis: String
- DocumentMetadata
-
Informasi tentang dokumen masukan.
Tipe: Objek DocumentMetadata
- IdentityDocuments
-
Daftar dokumen yang diproses oleh AnalyzeID. Termasuk nomor yang menunjukkan tempat mereka dalam daftar dan struktur respon untuk dokumen.
Jenis: ArrayIdentityDocumentobjek
Kesalahan
- AccessDeniedException
-
Anda tidak berwenang untuk melakukan tindakan. Gunakan Amazon Resource Name (ARN) dari pengguna resmi atau IAM role untuk melakukan operasi.
Kode Status HTTP: 400
- BadDocumentException
-
Amazon Textract tidak dapat membaca dokumen. Untuk informasi selengkapnya tentang batas dokumen di Amazon Textract, lihatBatas Keras di Amazon Textract.
Kode Status HTTP: 400
- DocumentTooLargeException
-
Dokumen tidak dapat diproses karena terlalu besar. Ukuran dokumen maksimum untuk operasi sinkron 10 MB. Ukuran dokumen maksimum untuk operasi asinkron adalah 500 MB untuk file PDF.
Kode Status HTTP: 400
- InternalServerError
-
Amazon Textract Texact mengalami masalah layanan. Coba lagi panggilan Anda.
Kode Status HTTP: 500
- InvalidParameterException
-
Parameter input melanggar batasan. Misalnya, dalam operasi sinkron, sebuah
InvalidParameterException
pengecualian terjadi ketika salah satuS3Object
atauBytes
nilai-nilai yang disediakan dalamDocument
parameter permintaan. Validasi parameter Anda sebelum memanggil operasi API lagi.Kode Status HTTP: 400
- InvalidS3ObjectException
-
Amazon Textract Texact tidak dapat mengakses objek S3 yang ditentukan dalam permintaan. untuk informasi selengkapnya,Mengonfigurasi Akses ke Amazon S3Untuk informasi pemecahan masalah, lihatPemecahan Masalah Amazon S3
Kode Status HTTP: 400
- ProvisionedThroughputExceededException
-
Jumlah permintaan melebihi batas throughput Anda. Jika Anda ingin meningkatkan batas ini, hubungi Amazon Textract.
Kode Status HTTP: 400
- ThrottlingException
-
Amazon Textract untuk sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda.
Kode Status HTTP: 500
- UnsupportedDocumentException
-
Format dokumen input tidak didukung. Dokumen untuk operasi dapat dalam format PNG, JPEG, PDF, atau TIFF.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API di salah satu bahasa khusus bahasaAWSSDK, lihat berikut ini: