Codes de réponse d’erreur des API Cloud de Document Understanding

Depending on your use case, you can use two types of calls for Document Understanding^TM Cloud APIs: synchronous (sync) and asynchronous (async).

Common issues concerning Document Understanding^TM Cloud APIs are outlined in this page.

Gestion des erreurs pour les appels de synchronisation

Si des erreurs se produisent, l’appel synchrone renverra un code de statut HTTP approprié, accompagné des éléments suivants :

• Code d’erreur : code spécifique qui identifie le type d’erreur.
• Message d’erreur : explication détaillée qui décrit l’erreur.

Gestion des erreurs pour les appels asynchrones

En cas d’erreurs, l’URL qui en résulte fournit les éléments suivants :

• Code d’erreur : code spécifique qui identifie le type d’erreur.
• Message d’erreur : explication détaillée qui décrit l’erreur.

Si l’objet operationId (renvoyé par l’opération de démarrage) est trouvé, la route des résultats renverra de manière persistante un statut 202 (applicable même aux requêtes infructueuses) et les détails de l’erreur figureront dans le corps de la réponse.

Pour plus de détails et d’exemples, consultez la documentation Swagger.

Tâche de numérisation ou ID de document introuvable

Si la tâche de numérisation ou l’ID du document est introuvable, un message d’erreur est généré :

• Si vous utilisez les API synchrones de classification ou d’extraction, une erreur 404, Code:[DocumentIdNotFound] s’affiche.
• Si vous utilisez les API asynchrones pour la classification ou l’extraction, la requête GET renverra une erreur 200, Code:[DocumentIdNotFound].

Dans les deux cas, le message d’erreur suivant est généré :

Cannot perform the operation for the given documentId: Ensure it is correct, the digitization is successful (retrieving the digitization result), and not more than 7 days since the digitization call passed (case in which, it expired).

Étapes de résolution

1. Vérifiez le résultat de la numérisation appelant /digitization/result/{documentId}.
2. Réessayez le processus de numérisation.
3. Une fois le nouvel ID de document généré lors de la nouvelle tentative, utilisez-le pour classer et extraire les données.

Échec de la numérisation en raison d’une erreur client

Dans certains cas, un échec de numérisation en raison d’une erreur client peut entraîner un message d’erreur. Il s’agit d’une erreur 400, qui s’affiche comme suit : Code: [DigitizationErrorCode], Message: "DigitizationErrorMessage". Le code d’erreur et le message correspondant peuvent avoir l’une des valeurs suivantes :

[UnsupportedContentTypeError]", "Content type of the input document is not supported."
[UnexpectedPdfStructureError]", "Invalid or corrupt PDF structure."
[InvalidImageSizeError]", "Image size of the input document is not supported."
[UnableToProcessContentError]", "Unable to process document contents."
[ContentTypeMismatchError]", "Declared content-type of the input document does not match the binary content type."
[PasswordProtectedPdfError]", "Password protected PDFs are not supported."
[MaximumNumberOfPagesPerDocumentLimitExceededError]", "Maximum number of pages for digitization exceeded."
[InvalidRequestData]", "The form data in the request is invalid. Expected is a multi-part form data, with either one part consisting of the document to be digitized, or two named parts: File - the document, DigitizationResult - the digitization result, with content type application/json."
[UnexpectedDigitizationResultStructure]", "The digitization result object is invalid and non-serializable."
[InvalidDom]", "The provided DOM is invalid. Make sure the DOM is correctly built, including valid non-overlapping indices, well formed boxes and polygons and valid values for all properties."
[MismatchingDomAndContent]", "The provided DOM and content do not match. Make sure the DOM was generated on the provided document."
[MismatchingDomAndText]", "The provided DOM and text do not match. Make sure the text and DOM were generated on the same document."
[PreprocessingOptionIncompatibleWithDigitizationResult]", "Using the preprocessing option while also providing a digitization result input is not supported."
[InvalidOcrApiKeyError]", "OCR Api key is invalid."
[OcrTooManyRequestsError]", "OCR request quota exceeded."
[ExternalOcrTooManyRequestsError]", "OCR request quota exceeded."
[GoogleBillingNotEnabled]", "Google OCR billing is not enabled. Please enable billing in your Google Cloud Platform account."
[GoogleApiKeyExpired]", "Google OCR Api Key Expired."
[InvalidOcrUrlError]", "The provided OCR URL is invalid or malformed."
[InvalidResponseFromOcrEngineError]", "Invalid response received from the OCR engine. Please set another OCR engine for the project you are using."

Échec de la numérisation en raison d’une erreur serveur

Si la numérisation a échoué en raison d’une erreur serveur, cela peut générer un message d’erreur. Il s’agit d’une erreur 500, qui s’affiche comme suit : Code: [DigitizationFailedServerError], Message: Internal Server Error.

Si vous rencontrez cette erreur, nous vous recommandons de contacter l’équipe d’assistance UiPath® .

Échec de la numérisation en raison du nombre de pages

Si la numérisation pour les appels synchrones échoue parce que le document comporte plus de cinq pages, un message d’erreur est généré. Il s’agit d’une erreur 400, qui s’affiche comme suit : Code: [SyncMaximumNumberOfPagesExceeded], Message: Maximum Number Of Pages Exceeded.

If you encounter this error, use asysnchronous APIs. Asynchronous APIs are always recommended for production use cases. Synchronous APIs are only recommended in the following situations:

• When you are certain that you will never have more than five pages.
• If you only have single-page images, no PDFs or TIFFs.
• When preparing proof of concepts or demos.