Errors

Triverse uses standard HTTP response codes to indicate the success or failure of an API request. In general:

• Codes in the 2xx range indicate success.
• Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.).
• Codes in the 5xx range indicate an error with Triverse's servers.

Error Response Structure

When an error occurs, the response body contains a standard error object:

{
  "code": 2004,
  "message": "The file type is unsupported.",
  "suggestion": "The provided file type 'image/gif' is not supported. Please use one of: image/jpeg, image/png, image/webp."
}

Error Code Reference

The following table lists the internal error codes you might encounter:

Handling Errors

We recommend implementing robust error handling in your integration:

1. Check HTTP Status: Always check the HTTP status code first.
2. Log Internal Codes: Log the code field for debugging and support purposes.
3. User Feedback: Use the message and suggestion fields to provide helpful feedback to your users.
4. Retry Logic: For 503 errors, implement an exponential backoff retry strategy. For 429 errors, wait before retrying.