Error Handling

Common HTTP codes:

• 400 Bad Request: validation or missing parameters
• 401 Unauthorized: invalid or expired token, missing signature
• 403 Forbidden: resource not allowed for this API client
• 404 Not Found: resource does not exist
• 409 Conflict: duplicate or incompatible state
• 429 Too Many Requests: rate limit exceeded
• 500 Internal Server Error: unexpected errors

Handling Strategy

• Retry only on 429 or transient 500 errors (with exponential backoff).
• Do not retry 400 or 403 until the request is corrected.