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

Selon votre cas d’utilisation, vous pouvez utiliser deux types d’appels pour les API Cloud de Document Understanding^TM : synchrone (sync) et asynchrone (async).

Les problèmes courants concernant les API Cloud de Document Understanding^TM sont décrits sur cette 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®.