Errors
Handle Corinthian API failures by relying on HTTP status, the returned message, and validation details.
Corinthian does not document one rigid shared error envelope across every endpoint. Integrations should rely on:
- the HTTP status code
- the returned
message - any field-level validation details included by the endpoint
Practical Handling Rules
- treat
401and403as authentication or permission problems - treat
404as a missing resource or endpoint - treat
422or validation failures as request-shape problems - treat
429as a rate-limit response and back off - log the server message and request identifier when available
Guidance
- do not hardcode one old
error.type/error.codeenvelope across the entire API - show validation messages to users or admins when the endpoint returns them
- build retry logic around status codes, not prose alone