Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
AnalyzeExpense
AnalyzeExpense
analysiert synchron ein Eingabedokument auf finanziell verwandte Beziehungen zwischen Text.
Informationen werden zurückgegeben alsExpenseDocuments
und zerstreut sich wie folgt.
-
LineItemGroups
- Ein Datensatz mitLineItems
welche Informationen über die Textzeilen speichern, z. B. einen gekauften Artikel und seinen Preis auf einer Quittung. -
SummaryFields
- Enthält alle anderen Informationen einer Quittung, wie Kopfdaten oder den Namen des Lieferanten.
Anforderungssyntax
{
"Document": {
"Bytes": blob
,
"S3Object": {
"Bucket": "string
",
"Name": "string
",
"Version": "string
"
}
}
}
Anfrageparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- Document
-
Das Eingabedokument, entweder als Byte oder als S3-Objekt.
Sie übergeben Bild-Bytes an eine Amazon Textract Textract-API-Operation, indem Sie die
Bytes
eigentum. Verwenden Sie zum Beispiel dieBytes
-Eigenschaft, um ein aus einem lokalen Dateisystem geladenes Dokument zu übergeben. Bildbytes, die mit demBytes
Die Eigenschaft muss base64-codiert werden. Ihr Code muss möglicherweise keine Dokumentdateibytes codieren, wenn Sie ein AWS SDK zum Aufrufen von Amazon Textract Textract-API-Operationen verwenden.Sie übergeben Bilder, die in einem S3-Bucket Amazon Textract, indem Sie die
S3Object
eigentum. Dokumente, die in einem S3-Bucket gespeichert sind, müssen nicht base64-codiert werden.Die AWS-Region für den S3-Bucket, der das S3-Objekt enthält, muss mit der von Ihnen für Amazon Textract Textract-Operationen verwendeten AWS-Region übereinstimmen.
Wenn Sie Amazon Textract Textract-Operationen mithilfe der AWS CLI aufrufen, wird die Weitergabe von Bild-Bytes mit der Bytes -Eigenschaft nicht unterstützt. Sie müssen zuerst das Dokument auf einen Amazon-S3-Bucket hochladen und anschließend die Operation mithilfe der S3Object-Eigenschaft aufrufen.
Damit Amazon Textract ein S3-Objekt verarbeiten kann, muss der Benutzer über die Berechtigung für den Zugriff auf das S3-Objekt verfügen.
Typ: Document Objekt
Erforderlich: Ja
Antwortsyntax
{
"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"
}
}
]
}
]
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- DocumentMetadata
-
Informationen über das Eingabedokument.
Typ: DocumentMetadata Objekt
- ExpenseDocuments
-
Die von Amazon Textract festgestellten Kosten.
Type: Array vonExpenseDocumentObjekte
Fehler
- AccessDeniedException
-
Sie sind nicht berechtigt, die Aktion auszuführen. Verwenden Sie den Amazon-Ressourcennamen (ARN) der IAM-Rolle oder eines autorisierten Benutzers, um den Vorgang auszuführen.
HTTP-Statuscode: 400
- BadDocumentException
-
Amazon Textract kann das Dokument nicht lesen. Weitere Informationen zu den Beleglimits in Amazon Textract finden Sie unterHard Limits in Amazon Textractaus.
HTTP-Statuscode: 400
- DocumentTooLargeException
-
Das Dokument kann nicht verarbeitet werden, da es zu groß ist. Die maximale Dokumentgröße für synchrone Operationen 10 MB. Die maximale Dokumentgröße für asynchrone Vorgänge beträgt 500 MB für PDF-Dateien.
HTTP-Statuscode: 400
- InternalServerError
-
Amazon Textract hat ein Service-Problem festgestellt. Wiederholen Sie den Aufruf.
HTTP-Statuscode: 500
- InvalidParameterException
-
Ein Eingabeparameter verletzt eine Beschränkung. Zum Beispiel wird bei synchronen Operationen ein
InvalidParameterException
Ausnahme tritt auf, wenn keiner derS3Object
oderBytes
Werte werden imDocument
Anforderungsparameter. Validieren Sie den Parameter, bevor Sie die API-Operation erneut aufrufen.HTTP-Statuscode: 400
- InvalidS3ObjectException
-
Amazon Textract kann auf das in der Anforderung angegebene S3-Objekt nicht zugreifen.Konfigurieren des Zugriffs auf Amazon S3Informationen zur Problembehebung finden Sie unterFehlerbehebung für Amazon S3
HTTP-Statuscode: 400
- ProvisionedThroughputExceededException
-
Die Anzahl der Anforderungen hat das Durchsatzlimit überschritten. Wenn Sie dieses Limit erhöhen müssen, wenden Sie sich an Amazon Textract.
HTTP-Statuscode: 400
- ThrottlingException
-
Amazon Textract kann die Anforderung vorübergehend nicht verarbeiten. Wiederholen Sie den Aufruf.
HTTP-Statuscode: 500
- UnsupportedDocumentException
-
Das Format des Eingabedokuments wird nicht unterstützt. Dokumente für Operationen können im PNG-, JPEG-, PDF- oder TIFF-Format vorliegen.
HTTP-Statuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: