Справочник ошибок
Base URLhttps://planet-project.click/api/v1
ДоступBearer token + whitelist IP
Лимит10 RPS на токен
ВерсияErrors v1
ОбновленоОбновлено 15 мая 2026
Справочник ошибок

Ошибки PlanetDomains API

Компактный справочник по ошибкам, с которыми интегратор реально сталкивается в торговых, DNS, whitelist и webhook-потоках. Держите его рядом, когда строите retries, панели и алерты.

Назад к docs OpenAPI JSON Webhook guide

Обзор

Классифицируйте сбой быстро
Самая чистая модель проста: 401/403 — это доступ, 404/422 — caller data или ownership, 409 — состояние или конфиг, 429 — нужно замедлиться.

Доступ и токен

Bearer + whitelist
401
unauthorized

Токен невалиден, отключён или уже перевыпущен.

Ошибка
КогдаКогда Bearer token не найден в системе или уже отключён.
СмыслНужно создать новый токен или использовать актуальный.
Развернуть деталиparams / body / response / notes

Связанные endpoints

GET /api/v1/account
Быстрый smoke-check токена.
POST /api/v1/domains/register
Частый рабочий метод, где ошибка видна сразу.

Операционные заметки

  • Проверьте, не был ли токен перевыпущен в Профиль -> API.
  • Убедитесь, что заголовок Authorization передаётся целиком.
403
forbidden

Whitelist пуст или IP сервера не совпал.

Ошибка
КогдаКогда токен валиден, но текущий IP не разрешён.
СмыслДоступ к рабочему API закрыт до корректного whitelist.
Развернуть деталиparams / body / response / notes

Связанные endpoints

GET /api/v1/account
Проверка доступа после исправления whitelist.

Операционные заметки

  • Добавьте IP сервера в Whitelist в боте.
  • Если используется proxy, проверьте real client IP.

Торговые ошибки

404 / 409 / 422 / batch items
404
domain_not_found

Домен не найден в вашем аккаунте или по заданному имени.

Ошибка
КогдаКогда detail, renew, DNS или NS идут по несуществующему домену.
СмыслCaller передал неправильное имя домена или работает не с тем пользователем.
Развернуть деталиparams / body / response / notes

Связанные endpoints

GET /api/v1/domains
Список доменов пользователя.
GET /api/v1/domains/{domain}
Подробности по домену.

Операционные заметки

  • Сначала проверьте список доменов пользователя.
  • Не предполагайте, что домен уже зарегистрирован только по search.
409
cloudflare_not_configured

Cloudflare-профиль не найден, выключен или не подходит этому домену.

Ошибка
КогдаКогда bind вызывается без корректного cloudflare_profile_key.
СмыслНужно сначала поправить профиль в боте или выбрать другой.
Развернуть деталиparams / body / response / notes

Связанные endpoints

POST /api/v1/domains/{domain}/cloudflare/bind
Рабочий bind-путь.

Операционные заметки

  • Проверьте Cloudflare в Конфигураторе.
  • Не смешивайте bind с неподготовленным профилем.
422
validation_error

Payload не прошёл проверку или requested config несовместим.

Ошибка
КогдаКогда caller передал плохие DNS records, NS, years или config override.
СмыслПроблема на стороне клиента, а не внешнего провайдера.
Развернуть деталиparams / body / response / notes

Связанные endpoints

PUT /api/v1/domains/{domain}/dns
Частый источник ошибок по DNS records.
POST /api/v1/domains/register
Регистрация с config override.

Операционные заметки

  • Покажите пользователю точное поле, которое не прошло валидацию.
  • Не делайте blind retry: сначала исправьте payload.

Инфраструктура

Cloudflare and provider steps
500
provider_error

Внешний provider или промежуточный шаг не смог завершить операцию.

Ошибка
КогдаКогда downstream возвращает неожиданную ошибку или timeout.
СмыслНужна диагностика по логам и иногда повтор с backoff.
Развернуть деталиparams / body / response / notes

Связанные endpoints

POST /api/v1/domains/register
Регистрация часто проходит через внешние шаги.
POST /api/v1/domains/{domain}/cloudflare/bind
Bind тоже зависит от внешней стороны.

Операционные заметки

  • Проверьте связанные provider-логи или webhook delivery history.
  • Не делайте агрессивный цикл повторов сразу после 500.

Лимиты и retry

10 RPS baseline
429
rate_limited

Токен упёрся в лимит и должен замедлиться.

Ошибка
КогдаКогда один токен идёт слишком быстро и превышает нормальный RPS.
СмыслТокен временно блокируется, чтобы не разнести API и provider path.
Развернуть деталиparams / body / response / notes

Связанные endpoints

POST /api/v1/domains/register/batch
Лучший путь для массовой торговли.
POST /api/v1/domains/renew/batch
Пакетный renew вместо множества одиночных запросов.

Операционные заметки

  • Вводите queueing или backoff на клиенте.
  • Для массовых операций сначала используйте batch.

Что делать дальше

Operational checklist
  1. Сначала разделяйте access issues, payload issues и pacing issues.
  2. 422 и batch-item ошибки возвращайте обратно в панель как точную подсказку, а не как общий сбой.
  3. 409 почти всегда означает, что сначала нужно поправить состояние или конфиг.
  4. 429 лечится не retry-штормом, а backoff и batch-логикой.
  5. Если ошибка связана с webhook, откройте delivery history и проверьте последнюю попытку.