Обрабатывайте ошибки API и повторные попытки

Всегда проверяйте HTTP-статус перед чтением ответа как успешного. Сервисы ShareAI могут возвращать разные форматы ошибок: инференс может предоставить error.code, OAuth предоставляет error и error_description, а маршруты Консоли могут возвращать code, message и data.status.

Статус	Типичное значение	Восстановление
200 с объектом ошибки	Результат недоступности устройства в текущей конечной точке чата.	Проверьте error.code и не отображайте его как ответ ассистента.
400	Неверный запрос или OAuth-грант.	Исправьте тело, параметры, обратный вызов или истёкший/использованный код.
401	Отсутствует, истек или недействителен аутентификационный токен.	Проверьте учетные данные; обновляйте только действующий OAuth-токен.
402	Недостаточно кредитов или доступного баланса.	Проверьте баланс выбранного аккаунта перед повторной попыткой.
403	Отказ в доступе по области, владению, роли или состоянию включения.	Проверьте задокументированные границы разрешений.
404	Неизвестный ресурс или неподдерживаемый маршрут шлюза.	Проверьте хост, путь и идентификаторы ресурсов.
409	Конфликт состояния или ревизии.	Прочитайте текущее состояние и пересмотрите изменение.
429	Лимит запросов или параллельности.	Соблюдайте Retry-After и используйте ограниченную обратную задержку.
500 / 502 / 503	Сбой доступности сервера или вышестоящего узла.	Ограничьте количество повторных попыток; сохраняйте диагностические идентификаторы.

Повторите чтение с ограничением#

При временных сбоях чтения ждите с увеличением задержки и джиттера, соблюдайте Retry-After, если он указан, и прекращайте после определенного количества попыток или временного бюджета. Показывайте пользователю, когда данные недоступны, вместо бесконечного цикла.

Обрабатывайте записи осторожно#

Не повторяйте автоматически обновление цен, создание модели или команду общего доступа, если результат неизвестен. Сначала прочитайте состояние ресурса или команды. Используйте Idempotency-Key только на конечных точках, которые документируют поддержку, например, изменения соглашений.

Токены обновления одноразовые#

Обновление токена требует блокировки на уровне авторизации в вашем бэкенде. Слепая повторная попытка использования токена обновления может аннулировать грант. См. безопасное обновление токена.

Что включить в запрос поддержки#

Включите конечную точку, HTTP-статус, код ошибки, время и идентификатор ответа/задачи, если они доступны. Удалите заголовки Authorization, cookies, клиентские секреты, токены доступа, токены обновления и содержимое приватных запросов.

Месячные лимиты расходов и восстановление платежей#

Каждый платный аккаунт может установить собственный месячный лимит расходов на ИИ для приложения или клиентского сервиса в разделе Billing → Subscriptions & Commitments. Лимит включает сетевые расходы и наценку разработчика, в то время как фиксированные подписки и подтвержденные покупки остаются отдельными. Ошибка лимита использует HTTP 402 application_spending_limit_exceeded; недостаточно подходящих кредитов использует HTTP 402 insufficient_credits. Оба предоставляют ссылку на выставление счетов клиенту. Пример контракта ошибки, обработки потоков и интеграции.