Ошибки и ограничения
| Код | Что означает | Что делать |
|---|---|---|
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). Они
относятся к несжатому выбранному массиву, поэтому размер скачанного файла может отличаться.