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

Dependendo do seu caso de uso, você pode usar dois tipos de chamadas para APIs do Document Understanding^TM Cloud: síncrona (sincronização) e assíncrona (sem sincronização).

Os problemas comuns relacionados às APIs do Document Understanding^TM Cloud são descritos nesta página.

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