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.