Authentication

The Kathan API uses Bearer token authentication for secure access to all endpoints except health checks.

Bearer Token Format

Include your API key in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

curl -H "Authorization: Bearer sk_live_your_key" \
  "https://api.dev.opencorpus.ai/protected"

{
  "message": "Hello, user user_xxx!",
  "user_id": "user_xxx"
}

Rate limit headers are included in responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1640995200

401 Unauthorized

{
  "detail": "Invalid authentication credentials"
}

429 Too Many Requests

{
  "detail": "Rate limit exceeded"
}