Использование

Для зарубежных интеграций стабильной проверкой аккаунта на сегодняшний день является Профиль. Используйте его для чтения кредитов, уровня и оставшейся квоты API перед крупными операциями. Выделенные конечные точки использования следует рассматривать как управляемые схемой: пути только для вызова присутствуют в GET /api/openapi.json.

Запрос

Профиль использует обычный запрос с проверкой подлинности носителя:

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

Ответ

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

Используйте ответ в качестве оперативного ограждения, а не в качестве оговорки. Другие работники могут использовать баланс после того, как вы его проверите.

Выставление счетов и кредиты

Храните снимки баланса дорогих партий. Если клиенты спрашивают, почему остановилась обработка пакета, сравните начальный снимок профиля, количество выполненных заданий, количество неудачных заданий и окончательный снимок профиля.

Ошибки

Ошибки профиля имеют общую форму ошибки API. Если в схеме появится конечная точка будущего использования, примените те же правила повтора и ведения журнала: запишите requestId, избегайте регистрации ключей API и приостановите создание пакета при недостаточном количестве кредитов.