Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AnalyzeExpense
AnalyzeExpenseanalizza in modo sincrono un documento di input per le relazioni finanziarie tra testo.
Le informazioni vengono restituite comeExpenseDocumentse separato come segue.
-
LineItemGroups- Un set di dati contenenteLineItemsche memorizzano informazioni sulle righe di testo, come un articolo acquistato e il suo prezzo su una ricevuta. -
SummaryFields- Contiene tutte le altre informazioni di una ricevuta, come le informazioni sull'intestazione o il nome del fornitore.
Sintassi della richiesta
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- Document
-
Il documento di input, sia come byte che come oggetto S3.
È possibile trasmettere i byte di immagine a un'operazione API di Amazon Textract utilizzando la
Bytesproprietà. Ad esempio, è possibile utilizzare laBytesproprietà per passare un documento caricato da un file system locale. Byte immagine passati usando ilBytesla proprietà deve essere codificata in base64. Il codice potrebbe non aver bisogno di codificare i byte dei file dei documenti se utilizzi un SDK AWS per chiamare le operazioni dell'API Amazon Textract.È possibile trasmettere le immagini archiviate in un bucket S3 a un'operazione API Amazon Textract di utilizzando la
S3Objectproprietà. I documenti archiviati in un bucket S3 non devono essere codificati con Base64.La regione AWS per il bucket S3 contenente l'oggetto S3 deve corrispondere alla regione AWS utilizzata per le operazioni Amazon Textract.
Se si utilizza AWS CLI per richiamare le operazioni Amazon Textract, la trasmissione dei byte di immagine utilizzando la proprietà Bytes non è supportata. È necessario prima caricare il documento in un bucket Amazon S3, quindi richiamare l'operazione utilizzando la proprietà S3Object.
Per consentire ad Amazon Textract di elaborare un oggetto S3, l'utente deve disporre dell'autorizzazione per accedere all'oggetto S3.
Tipo: Document oggetto
Campo obbligatorio: Sì
Sintassi della risposta
{
"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"
}
}
]
}
]
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- DocumentMetadata
-
Informazioni sul documento di input.
Tipo: DocumentMetadata oggetto
- ExpenseDocuments
-
Le spese rilevate da Amazon Textract.
Type: Matrice diExpenseDocumentoggetti
Errori
- AccessDeniedException
-
Non sei autorizzato a eseguire l'operazione. Utilizzare l'ARN (Amazon Resource Name) di un utente autorizzato o un ruolo IAM per eseguire l'operazione.
Codice di stato HTTP: 400
- BadDocumentException
-
Amazon Textract non è in grado di leggere il documento. Per ulteriori informazioni sui limiti dei documenti in Amazon Textract, consultaLimiti rigidi per Amazon Textract.
Codice di stato HTTP: 400
- DocumentTooLargeException
-
Il documento non può essere elaborato perché è troppo grande. La dimensione massima dei documenti per le operazioni sincrone 10 MB. La dimensione massima del documento per le operazioni asincrone è di 500 MB per i file PDF.
Codice di stato HTTP: 400
- InternalServerError
-
Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata.
Codice di stato HTTP: 500
- InvalidParameterException
-
Un parametro di input ha violato un vincolo. Ad esempio, nelle operazioni sincrone, un
InvalidParameterExceptioneccezione si verifica quando nessuno dei dueS3ObjectoBytesi valori sono forniti nelDocumentparametro di richiesta. Convalida il parametro prima di richiamare nuovamente l'operazione API.Codice di stato HTTP: 400
- InvalidS3ObjectException
-
Amazon Textract non è in grado di accedere all'oggetto S3 specificato nella richiesta. Per ulteriori informazioni,Configura l'accesso ad Amazon S3Per informazioni sulla risoluzione dei problemi, consultaRisoluzione dei problemi Amazon S3
Codice di stato HTTP: 400
- ProvisionedThroughputExceededException
-
Il numero di richieste ha superato il limite di throughput. Per aumentare questo limite, contatta Amazon Textract.
Codice di stato HTTP: 400
- ThrottlingException
-
Amazon Textract non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.
Codice di stato HTTP: 500
- UnsupportedDocumentException
-
Il formato del documento di input non è supportata. I documenti per le operazioni possono essere in formato PNG, JPEG, PDF o TIFF.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
