Error Handling

​

Error Format

All API errors follow a simple format:

{
  "error": "Detailed error message"
}

​

HTTP Status Codes

​

400 Bad Request

Indicates that the request was malformed or invalid.

{
  "error": "Invalid URL format"
}

{
  "error": "Invalid schema format"
}

{
  "error": "Invalid HTML content"
}

​

401 Unauthorized

Authentication-related errors.

{
  "error": "Invalid API key"
}

{
  "error": "Insufficient credits"
}

​

429 Too Many Requests

Rate limiting errors.

{
  "error": "Too many requests"
}

​

500 Server Error

Internal server errors.

{
  "error": "An error occurred while processing your request"
}

{
  "error": "Service temporarily unavailable"
}

​

Error Handling Best Practices

​

Retry Strategy

1. Retryable Errors

   • Rate limit exceeded (429)
   • Service unavailable (500, 503)
   • Network timeouts

2. Non-Retryable Errors

   • Invalid parameters (400)
   • Authentication errors (401)
   • Invalid schemas (400)

​

Example Error Handling

​

Support

If you encounter any errors not documented here or need assistance: