AnalyzeExpense - Amazon Textract

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AnalyzeExpense

AnalyzeExpenseserentak menganalisis dokumen masukan untuk hubungan finansial terkait antara teks.

Informasi dikembalikan sebagaiExpenseDocumentsdan terpisah sebagai berikut.

  • LineItemGroups- Sebuah set data yang berisiLineItemsyang menyimpan informasi tentang baris teks, seperti barang yang dibeli dan harganya pada tanda terima.

  • SummaryFields- Berisi semua informasi lain tanda terima, seperti informasi header atau nama vendor.

Sintaksis Permintaan

{ "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } }

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

Document

Dokumen input, baik sebagai byte atau sebagai objek S3.

Anda meneruskan bit citra ke operasi API Amazon Textract dengan menggunakan bitBytesproperti. Misalnya, Anda akan menggunakanBytesproperti untuk lulus dokumen yang dimuat dari sistem file lokal. Gambar byte dilewatkan dengan menggunakanBytesproperti harus dikodekan dengan base64. Kode Anda mungkin tidak perlu mengodekan byte file dokumen jika Anda menggunakan AWS SDK untuk memanggil operasi API Amazon Textract.

Anda meneruskan citra yang disimpan dalam bucket S3 ke operasi API Amazon Textract dengan menggunakan bucket S3 dengan menggunakan bucket S3 ke operasi API Amazon TS3Objectproperti. Dokumen yang disimpan dalam bucket S3 tidak perlu dikodekan dengan base64.

Wilayah AWS untuk bucket S3 yang berisi objek S3 harus sesuai dengan Wilayah AWS yang Anda gunakan untuk operasi Amazon Textract.

Jika Anda menggunakan AWS CLI untuk memanggil operasi Amazon Textract, meneruskan bit citra menggunakan properti Bit tidak didukung. Anda harus mengunggah dokumen terlebih dahulu ke bucket Amazon S3, lalu memanggil operasi menggunakan properti S3Object.

Agar Amazon Textract memproses objek S3, pengguna harus memiliki izin untuk mengakses objek S3.

Tipe: Objek Document

Diperlukan: Ya

Sintaksis Respons

{ "DocumentMetadata": { "Pages": number }, "ExpenseDocuments": [ { "ExpenseIndex": number, "LineItemGroups": [ { "LineItemGroupIndex": number, "LineItems": [ { "LineItemExpenseFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ], "SummaryFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

DocumentMetadata

Informasi tentang dokumen masukan.

Tipe: Objek DocumentMetadata

ExpenseDocuments

Biaya terdeteksi oleh Amazon Textract.

Jenis: ArrayExpenseDocumentobjek

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 mengalami masalah layanan. Coba lagi panggilan Anda.

Kode Status HTTP: 500

InvalidParameterException

Parameter input melanggar batasan. Misalnya, dalam operasi sinkron, sebuahInvalidParameterExceptionpengecualian terjadi ketika salah satuS3ObjectatauBytesnilai-nilai yang disediakan dalamDocumentparameter permintaan. Validasi parameter Anda sebelum memanggil operasi API lagi.

Kode Status HTTP: 400

InvalidS3ObjectException

Amazon Textract 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 ini di salah satu bahasa yang spesifikAWSSDK, lihat berikut ini: