SimpleClaw

API Reference

Ошибки и контракты

Единый формат ошибок и формы основных объектов API.

Контракты данных

Даты — ISO-8601 UTC, деньги — целые минимальные единицы валюты. Конкретные поля каждого ответа видны в карточке метода.

Ошибка

JSON ошибкиПоказать
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Ключ недействителен",
    "requestId": "uuid"
  }
}

Тариф (Plan)

JSON тарифаПоказать
{
  "code": "provider-month",
  "name": "Provider",
  "priceMinor": 99000,
  "currency": "RUB"
}

Подписка

JSON подпискиПоказать
{
  "planCode": "provider-month",
  "status": "ACTIVE",
  "autoRenew": true
}

Ошибки и как действовать

400 VALIDATION_ERROR — исправьте тело, query или заголовок.

401 UNAUTHENTICATED — нет сессии; 401 INVALID_API_KEY — ключ неверный или удалён.

403 USER_BLOCKED — учётная запись заблокирована; 403 PROVIDER_SUBSCRIPTION_REQUIRED — нужна Provider-подписка или предоплаченный баланс.

404 MODEL_UNAVAILABLE — модели нет в доступном каталоге.

409 IDENTITY_ALREADY_LINKED — способ входа уже принадлежит другой учётной записи.

429 CREDIT_QUOTA_EXCEEDED — недостаточно остатка в одном из окон credits; API_KEY_CREDIT_BUDGET_EXCEEDED — достигнут личный лимит ключа; PREPAID_CREDIT_BALANCE_EXCEEDED — закончился предоплаченный баланс.