Reliability
Error Handling
Every API error should be handled by code and readable by humans. Site Clinic returns structured error objects so apps can log, retry, or display the right next step.
Typical error shape
JSON
{
"error": {
"code": "validation_error",
"message": "The supplied URL is invalid.",
"request_id": "req_1234567890abcdef"
}
}Validation errors
Validation errors mean the request shape or input values are not acceptable. Fix the payload and retry without delay.
Authentication errors
Authentication errors usually come from missing Bearer headers, inactive keys, or mixing live and test credentials with the wrong environment.
System failures
Unexpected server errors should be logged with the request ID and routed to support. If the issue looks widespread, contact support before retrying aggressively.