Skip to content

Integration guide

Error handling

Error format and retry guidance.

Errors use one format:

{
"type": "https://docs.aigcgeo.com/errors/conflict",
"title": "CONFLICT",
"status": 409,
"detail": "The request conflicts with the current state",
"requestId": "01J5EXAMPLE"
}

Validation errors also include errors with field names and reasons.

HTTP Meaning Action
401 Invalid credential Check the token
402 Insufficient points Add points before submitting
404 Record not found Check the identifier and account
409 Operation is not valid in the current state Correct the request using detail
422 Invalid parameters Correct fields listed in errors
429 Too many requests Retry after a delay
504 Request timed out Retry creation with the same idempotency key

Provide X-Request-ID, request time, and endpoint when contacting support.