400
Исправьте структуру JSON, обязательные поля, диапазоны и совместимость параметров.
Доступно
Ошибки API: что исправлять и когда повторять
Практический разбор HTTP 400, 401, 402, 404, 405, 409, 413, 429, 500 и 503 с безопасной политикой повторов.
API Токенмоста работает
Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.
Как это устроено
Ошибки клиента нужно исправлять, а не повторять. Сетевой таймаут и 5xx могут иметь неопределённый исход, поэтому повтор платного POST выполняется только с исходным Idempotency-Key и неизменным телом.
Что потребуется
- HTTP-статус, безопасный код ошибки и Idempotency-Key операции.
- Локальный журнал без полного API-ключа и пользовательских секретов.
- Разделение ошибки до отправки, подтверждённого отказа и неизвестного результата.
Порядок работы
- Запишите статус, безопасный код, endpoint и локальный ID операции.
- Для 4xx исправьте ключ, путь, тело, лимит или баланс до следующей попытки.
- Для 409 восстановите исходное тело либо создайте новый ключ только для новой операции.
- Для 429 соблюдайте Retry-After и ограничьте параллелизм.
- После таймаута или 5xx повторяйте только с тем же Idempotency-Key.
Готовая конфигурация
Базовая политика
400/401/402/404/405/409/413: исправить причину
429: ждать Retry-After и снизить частоту
500/503/таймаут: проверить историю, повторять с тем же Idempotency-Key
никогда: не создавать новый ключ для слепого повтораЧто учесть
Не показывайте пользователю внутренние сообщения поставщика и не повторяйте платные операции новым ключом после неопределённого результата.
Ошибки до генерации
Валидация JSON, авторизации, баланса и лимитов происходит до вызова модели. После исправления причины новое пользовательское действие получает новый Idempotency-Key.
Неизвестный исход
Разрыв соединения или часть потока не доказывают отсутствие генерации у поставщика. Сервис удерживает резерв для сверки; автоматический fallback или новый платный запрос может удвоить расход.
Безопасные журналы
Сохраняйте статус, код, длительность и локальные ID. Не записывайте API-ключ, полное тело с персональными данными или сырой ответ внешнего поставщика.
Ошибки и диагностика
401
Проверьте схему авторизации, срок, статус и фактически загруженный секрет.
402
Проверьте баланс, резервы и бюджет ключа.
409
Не меняйте тело существующей операции; новый ключ используйте только для нового действия.
429
Соблюдайте Retry-After и уменьшите частоту/параллелизм.
500 или 503
Сохраните Idempotency-Key, проверьте историю и не запускайте бесконечные повторы.