Error Handling

​

Common Errors

• 400 invalid_request_error — The request is malformed or missing required parameters.
• 401 authentication_error — Missing or invalid API key / token.
• 403 permission_error — Access to the resource is forbidden.
• 429 rate_limit_error — You have exceeded your rate limit.
• 500 api_error — Internal server error.
• 503 overloaded_error — Service temporarily unavailable.

​

Error Response Example

{
  "error": {
    "code": "invalid_request_error",
    "message": "Parameter 'messages' is required.",
    "type": "invalid_request_error"
  }
}

​

Retry & Recovery

• Use exponential backoff for retry attempts.
• Implement circuit breaker patterns to avoid retry storms.
• Validate inputs before retrying.

​

Language Bindings (Code Snippets)

• Python

import requests
headers = {"Authorization": "Bearer YOUR_NEOSANTARA_API_KEY"}
payload = {"model": "garda-core", "messages": [{"role": "user", "content": "Hello"}]}
resp = requests.post("https://api.neosantara.xyz/v1/chat/completions", json=payload, headers=headers)

• JavaScript

const payload = {
  model: "garda-core",
  messages: [{ role: "user", content: "Hello" }]
};

const res = await fetch("https://api.neosantara.xyz/v1/chat/completions", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_NEOSANTARA_API_KEY' },
  body: JSON.stringify(payload)
})