一般的な API エラー - Automation Anywhere EKB Docs

この記事は、EKB のクラウドプラットフォームを利用するときに発生する可能性のある最も一般的な API エラーを理解するのに役立ちます。さまざまな HTTP ステータスコードと特定のエラーコードの詳細が表示され、これらの問題を効果的に解決するための重要なトラブルシューティング手順が提供されます。エラー応答の形式と API の使用に関連する一般的な落とし穴を理解することで、エラーを処理し、開発エクスペリエンスを向上させるための準備が整います。

エラー応答フォーマット

すべての API エラーは一貫した形式に従います。

{
  "status_code": 400,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  },
  "detail": "Additional error details (optional)"
}

一部のエラーには次のものも含まれる場合があります。

error_id: エラーを追跡するための一意の識別子
invalid_fields: 検証に失敗したフィールドのリスト (検証エラーの場合)

HTTP ステータスコード

400 不正なリクエスト

無効な入力または不正な形式のリクエストによるクライアント側のエラー。

VALIDATION_ERROR

エラーコード: VALIDATION_ERROR ステータスコード: 400説明: リクエストの検証に失敗しました。リクエスト内の 1 つ以上のフィールドが無効です。一般的な原因:

必須フィールドが不足しています
- 無効なフィールド形式 (無効な電子メール、日付形式など)
- 許容範囲外のフィールド値
- 無効なデータ型

応答例:

{
  "status_code": 400,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "invalid_fields": ["email", "project_id"]
  }
}

トラブルシューティング:

invalid_fields 配列を確認して、問題のあるフィールドを特定します
API ドキュメントのフィールド要件を確認します。
データ型が予期される形式と一致することを確認します
必須フィールドがすべて入力されていることを確認します

INVALID_API_KEY

Error Code: PLACEHOLDER_1
Status Code: PLACEHOLDER_2Description: The provided API key is invalid or malformed.Troubleshooting:

Verify the API key is correctly copied (no extra spaces)
Check if the API key is active in My Account > API Keys
Ensure you’re using the correct API key for your environment
Regenerate the API key if necessary

INVALID_CREDENTIALS

Error Code: PLACEHOLDER_3
Status Code: PLACEHOLDER_4Description: Authentication credentials are invalid.Troubleshooting:

Verify email and password are correct
Check if account is locked or disabled
Try resetting your password
Ensure you’re using the correct authentication method

INVALID_OR_EXPIRED_JWT_TOKEN

Error Code: PLACEHOLDER_5
Status Code: PLACEHOLDER_6Description: The JWT token is invalid, expired, or malformed.Troubleshooting:

Refresh your authentication token
Log out and log back in
Check token expiration time
Verify token is being sent in the correct header format

401 不正

認証が必要か、認証に失敗しました。

AUTHENTICATION

Error Code: PLACEHOLDER_7
Status Code: PLACEHOLDER_8Description: Authentication is required to access this resource.Troubleshooting:

Ensure you’re logged in
Check if your session has expired
Verify authentication headers are included in the request
Re-authenticate if necessary

INVALID_BEARER_TOKEN

Error Code: PLACEHOLDER_9
Status Code: PLACEHOLDER_10Description: The Bearer token provided is invalid.Troubleshooting:

Verify the token format: PLACEHOLDER_11
Check if the token has expired
Regenerate authentication token
Ensure token is not revoked

EMAIL_IS_NOT_VERIFIED

Error Code: PLACEHOLDER_12
Status Code: PLACEHOLDER_13Description: Email address has not been verified.Troubleshooting:

Check your email for verification link
Request a new verification email
Verify email address is correct
Check spam/junk folder

403 禁止

権限が不十分なため、アクセスが拒否されました。

AUTHORIZATION

Error Code: PLACEHOLDER_14
Status Code: PLACEHOLDER_15Description: You don’t have permission to perform this action.Troubleshooting:

Verify you have the required role/permissions
Check if you’re a member of the project/team
Contact project/team admin to grant access
Ensure you’re accessing the correct resource

PERMISSION_DENIED

Error Code: PLACEHOLDER_16
Status Code: PLACEHOLDER_17Description: Permission denied for the requested operation.Troubleshooting:

Review your user role and permissions
Check project/team access settings
Verify resource ownership
Contact administrator for access

DOMAIN_NOT_ALLOWED

Error Code: PLACEHOLDER_18
Status Code: PLACEHOLDER_19Description: Your email domain is not allowed for this operation.Troubleshooting:

Verify your email domain is whitelisted
Contact administrator to add your domain
Use an allowed email address

404 見つかりません

要求されたリソースは存在しません。

ENTITY_NOT_FOUND

Error Code: PLACEHOLDER_20
Status Code: PLACEHOLDER_21Description: The requested resource was not found.Common Scenarios:

Project not found
Agent not found
Document not found
User not found

Troubleshooting:

Verify the resource ID is correct
Check if the resource was deleted
Ensure you have access to the resource
Verify you’re using the correct project/workspace

FILE_NOT_FOUND

Error Code: PLACEHOLDER_22
Status Code: PLACEHOLDER_23Description: The requested file does not exist.Troubleshooting:

Verify the file ID or path is correct
Check if the file was deleted
Ensure the file is in the expected location
Verify file permissions

FLOW_NOT_FOUND

Error Code: PLACEHOLDER_24
Status Code: PLACEHOLDER_25Description: The requested workflow/flow was not found.Troubleshooting:

Verify the flow ID is correct
Check if the flow was deleted
Ensure you have access to the flow
Verify the flow exists in the current project

CONFIG_NOT_FOUND

Error Code: PLACEHOLDER_26
Status Code: PLACEHOLDER_27Description: Required configuration was not found.Troubleshooting:

Verify configuration exists
Check configuration setup in settings
Ensure required services are configured
Review configuration documentation

500 内部サーバーエラー

調査が必要なサーバー側のエラー。

ENGINE_OPERATION_FAILURE

Error Code: PLACEHOLDER_28
Status Code: PLACEHOLDER_29Description: An internal engine operation failed.Troubleshooting:

Retry the request after a few moments
Check system status at PLACEHOLDER_30
If persistent, contact support with error details
Provide error ID if available

EXTERNAL_SERVICE

Error Code: PLACEHOLDER_31
Status Code: PLACEHOLDER_32Description: An external service required for this operation failed.Common Scenarios:

LLM provider API failure
Third-party integration failure (Google Drive, Slack, etc.)
External API timeout

Troubleshooting:

Check external service status
Verify API keys/credentials for external services
Retry the request
Check integration configuration
Contact support if issue persists

INFRASTRUCTURE

Error Code: PLACEHOLDER_33
Status Code: PLACEHOLDER_34Description: Infrastructure error (database, storage, etc.).Troubleshooting:

Retry the request
Check system status
If persistent, contact support
Provide error details and timestamp

OPEN_AI_FAILED

Error Code: PLACEHOLDER_35
Status Code: PLACEHOLDER_36Description: OpenAI API call failed.Troubleshooting:

Check OpenAI service status
Verify API key is valid and has credits
Check rate limits
Retry with exponential backoff
Verify model availability

503 サービスは利用できません

サービスが一時的に利用できなくなりました。

EXECUTION_TIMEOUT

Error Code: PLACEHOLDER_37
Status Code: PLACEHOLDER_38Description: Operation timed out.Troubleshooting:

Retry the request
Simplify the operation if possible
Check if system is under heavy load
Break down large operations into smaller ones
Contact support if timeout persists

ビジネスロジックエラー

QUOTA_EXCEEDED

Error Code: PLACEHOLDER_39
Status Code: PLACEHOLDER_40 or PLACEHOLDER_41Description: You have exceeded your quota limit.Troubleshooting:

Check your current usage in My Account > Dashboard
Review subscription limits
Upgrade your plan if needed
Wait for quota reset period
Contact sales for quota increase

FEATURE_DISABLED

Error Code: PLACEHOLDER_42
Status Code: PLACEHOLDER_43Description: This feature is disabled for your account.Troubleshooting:

Check your subscription plan
Verify feature availability
Upgrade plan if feature requires higher tier
Contact support for feature access

FLOW_IN_USE

Error Code: PLACEHOLDER_44
Status Code: PLACEHOLDER_45Description: The workflow is currently in use and cannot be modified.Troubleshooting:

Wait for active executions to complete
Cancel active workflow runs
Check workflow execution status
Retry after executions complete

EXISTING_USER

Error Code: PLACEHOLDER_46
Status Code: PLACEHOLDER_47Description: User with this email already exists.Troubleshooting:

Try logging in instead of signing up
Use password reset if you forgot credentials
Use a different email address
Contact support if account recovery is needed

統合固有のエラー

INVALID_APP_CONNECTION

Error Code: PLACEHOLDER_48
Status Code: PLACEHOLDER_49Description: Invalid or expired app connection (OAuth integration).Troubleshooting:

Re-authenticate the integration
Check OAuth token expiration
Verify integration credentials
Reconnect the integration in settings

INVALID_SAML_RESPONSE

Error Code: PLACEHOLDER_50
Status Code: PLACEHOLDER_51Description: Invalid SAML response from SSO provider.Troubleshooting:

Verify SSO configuration
Check SAML metadata URL
Ensure SSO provider is accessible
Contact support for SSO configuration review

RATE_LIMITED

Error Code: PLACEHOLDER_52 or PLACEHOLDER_53
Status Code: PLACEHOLDER_54Description: API rate limit exceeded.Troubleshooting:

Wait for rate limit window to reset
Implement exponential backoff
Reduce request frequency
Check rate limit headers in response
Upgrade plan for higher rate limits

助けを求める

ここに記載されていないエラーが発生した場合、またはサポートが必要な場合は、次の手順を実行してください。

エラーの詳細を確認: エラーコード、メッセージ、および error_id をメモします。
システムステータスを確認: 既知の問題については、status.getodin.ai にアクセスしてください。
ドキュメントの確認: 関連する API ドキュメントを確認します。
サポートに連絡: Support に次の内容を電子メールで送信します。
- エラーコードとメッセージ
- エラー ID (利用可能な場合)
- 再現手順
- リクエスト/レスポンスの詳細 (サニタイズ済み)
- エラーのタイムスタンプ

​エラー応答フォーマット

​HTTP ステータス コード

​400 不正なリクエスト

​401 不正

​403 禁止

​404 見つかりません

​500 内部サーバーエラー

​503 サービスは利用できません

​ビジネス ロジック エラー

​統合固有のエラー

​助けを求める