Códigos de resposta de erro das APIs do Document Understanding Cloud

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.

Tratamento de erros para chamadas síncronas

Se ocorrerem erros, a chamada síncrona retornará um código de status HTTP apropriado, acompanhado por:

• Código de erro: código específico que identifica o tipo de erro.
• Mensagem de erro: explicação detalhada que descreve o que é o erro.

Tratamento de erros para chamadas assíncronas

Em caso de erros, a URL resultante fornece o seguinte:

• Código de erro: código específico que identifica o tipo de erro.
• Mensagem de erro: explicação detalhada que descreve o que é o erro.

Se o operationId (retornado pela operação de início) for encontrado, a rota de resultados retornará persistentemente um status 202 (aplicável mesmo a solicitações não bem-sucedidas), e os detalhes do erro estarão no corpo da resposta.

Para obter detalhes e exemplos adicionais, consulte a documentação do Swagger.

Trabalho de digitalização ou IdDoDocumento não encontrado

Se o trabalho de digitalização ou IdDoDocumento não for encontrado, uma mensagem de erro será gerada:

• Se você usar as APIs síncronas de Classificação ou Extração, um erro 404, Code:[DocumentIdNotFound] será exibido.
• Se você usar as APIs assíncronas para Classificação ou Extração, o resultado retornará um erro 200, Code:[DocumentIdNotFound].

Em ambas as situações, a seguinte mensagem de erro é gerada:

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).

Etapas de resolução

1. Verifique o resultado da chamada de digitalização /digitization/result/{documentId}.
2. Tente novamente o processo de digitalização.
3. Depois que o novo ID do documento for gerado a partir da nova tentativa, use-o para classificar e extrair dados.

Falha na digitalização devido ao erro do cliente

Em alguns casos, uma digitalização com falha devido a um erro de cliente pode resultar em uma mensagem de erro. Esse é um erro 400, que é exibido da seguinte forma: Code: [DigitizationErrorCode], Message: "DigitizationErrorMessage". O código de erro e a mensagem correspondente podem ter um dos seguintes valores:

[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."

Falha na digitalização devido ao erro do servidor

Se a digitalização falhar devido a um erro de servidor, isso pode gerar uma mensagem de erro. Esse é um erro 500, que é exibido da seguinte forma: Code: [DigitizationFailedServerError], Message: Internal Server Error.

Se você encontrar esse erro, recomendamos entrar em contato com a equipe de Suporte da UiPath® .

Falha na digitalização devido ao número de páginas

Se a digitalização falhar para chamadas síncronas falhar devido ao documento ter mais de cinco páginas, uma mensagem de erro será gerada. Esse é um erro 400 , que é exibido da seguinte maneira: 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.