GLOBAL ERROR RESPONSES

Code	Meaning	Description
400	Bad Request	Invalid or missing parameters
401	Unauthorized	Invalid or expired token
402	Payment Required	Payment failed or declined
403	Forbidden	Subscription or permission required
404	Not Found	Resource does not exist
409	Conflict	Duplicate resource or state conflict
422	Unprocessable Entity	Request body validation failed
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Unexpected server failure

Example: Generic error

{
  "status": "error",
  "code": 403,
  "message": "Subscription required to access this content"
}

Example: Validation error (422)

{
  "status": "error",
  "code": 422,
  "errors": [
    { "field": "email", "message": "Invalid email format" },
    { "field": "channel_name", "message": "Channel name is required" }
  ]
}

Example: Rate limit (429)

{
  "status": "error",
  "code": 429,
  "message": "Rate limit exceeded. Max 10 requests/second.",
  "retry_after_seconds": 1
}