Document Understanding Cloud API のエラー応答コード

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.

同期呼び出しのエラー処理

エラーが発生した場合、同期呼び出しは以下の情報を伴う適切な HTTP ステータス コードを返します。

• エラー コード: エラーの種類を識別する特定のコード。
• エラー メッセージ: エラーの内容を説明する詳細な説明。

非同期呼び出しのエラー処理

エラーの場合、結果の URL に次の情報が表示されます。

• エラー コード: エラーの種類を識別する特定のコード。
• エラー メッセージ: エラーの内容を説明する詳細な説明。

operationId (開始操作によって返される) が見つかった場合、結果ルートは永続的に 202 ステータス (失敗した要求にも適用可能) を返し、エラーの詳細は応答の本文に含まれます。

詳細と具体例については、Swagger のドキュメントをご覧ください。

デジタル化ジョブまたはドキュメント ID が見つからない

デジタル化ジョブまたはドキュメント ID が見つからない場合、次のエラー メッセージが生成されます。

• 分類同期 API または抽出同期 API のいずれかを使用する場合は、404, Code:[DocumentIdNotFound] エラーが表示されます。
• 分類または抽出のいずれかに非同期 API を使用する場合は、get result により 200, Code:[DocumentIdNotFound] エラーが返されます。

どちらの場合も、次のエラー メッセージが生成されます。

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

解決手順

1. /digitization/result/{documentId} を呼び出して、デジタル化の結果を確認します。
2. デジタル化プロセスをリトライします。
3. リトライから新しいドキュメント ID が生成されたら、それを使用してデータを分類および抽出します。

クライアント エラーによりデジタル化に失敗する

場合によっては、クライアント エラーが原因でデジタル化に失敗すると、エラー メッセージが表示されることがあります。これは 400 エラーで、Code: [DigitizationErrorCode], Message: "DigitizationErrorMessage" のように表示されます。エラー コードと対応するメッセージは、次のいずれかの値になります。

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

サーバー エラーによりデジタル化に失敗する

サーバー エラーが原因でデジタル化に失敗した場合、エラー メッセージが生成されることがあります。これは 500 エラーで、Code: [DigitizationFailedServerError], Message: Internal Server Error のように表示されます。

このエラーが発生した場合は、UiPath® のサポート チームに連絡することをお勧めします。

ページ数によりデジタル化に失敗する

ドキュメントが 5 ページを超えることが原因で同期呼び出しでデジタル化に失敗した場合、エラー メッセージが生成されます。これは 400 エラーで、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.