Перейти к содержимому

Ошибки и ограничения

Код Что означает Что делать
400 Некорректные параметры или конфликт диапазонов Проверить query и live OpenAPI
401 Нет ключа, ключ неверен или отозван Передать X-API-Key, при необходимости выпустить новый
402 Нет активной подписки или кредитов для операции Проверить /api/account/me, активировать тариф
403 Операция требует администратора Обратиться к оператору
404 Группа, переменная, ключ или embedding отсутствуют Сначала запросить каталог
413 Запрошенный .npy больше установленного лимита Уменьшить bbox, время, lead, level или feature-срез
503 Хранилище, прогноз или внешняя платёжная система не готовы Повторить с backoff и проверить readiness
  • Устанавливайте таймаут и повторяйте только 429, 502, 503, 504 с exponential backoff.
  • Не повторяйте автоматически POST регистрации, создания ключей или запуска расчёта без собственной идемпотентности.
  • Сначала читайте каталог/metadata, затем запрашивайте ограниченный диапазон.
  • Кешируйте публичные тайлы согласно Cache-Control; не обходите карту через /field.
  • Логируйте request id из ответа/контекста, но не полный ключ и не query string с ключом.

Лимиты экспорта задаёт оператор (field_export_max_mb, embeddings_api_max_mb). Они относятся к несжатому выбранному массиву, поэтому размер скачанного файла может отличаться.