English

Error Handling

The Shadow API uses standard HTTP status codes and returns structured error responses.

HTTP Status Codes

Status	Meaning
`200`	Success
`201`	Created
`400`	Bad Request — invalid parameters
`401`	Unauthorized — missing or invalid token
`403`	Forbidden — insufficient permissions
`404`	Not Found — resource does not exist
`409`	Conflict — resource already exists
`429`	Too Many Requests — rate limited
`500`	Internal Server Error

Error Response Format

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

SDK Error Handling

import { ShadowClient } from '@shadowob/sdk'

const client = new ShadowClient('https://shadowob.com', 'token')

try {
  const server = await client.getServer('invalid-id')
} catch (error) {
  // Error message includes method, path, status, and body
  // "Shadow API GET /api/servers/invalid-id failed (404): ..."
  console.error(error.message)
}

Rate Limiting

The API may return 429 Too Many Requests when rate limits are exceeded. Implement exponential backoff when you receive this status code.

ON THIS PAGE

#Error Handling

#HTTP Status Codes

#Error Response Format

#SDK Error Handling

#Rate Limiting

Error Handling

HTTP Status Codes

Error Response Format

SDK Error Handling

Rate Limiting