Бизнес-правила и справочник эндпоинтов

Правила зон

• Максимум 300 зон на аккаунт пользователя (ошибка 1016)
• Уникальность в рамках пользователя — у одного пользователя не может быть двух зон с одинаковым именем (ошибка 1003). Разные пользователи МОГУТ создавать зоны с одинаковым именем — multi-zone ownership с верификацией (первая зона: active, последующие: pending)
• Авто-назначение NS — 3 NS-сервера из ns_pool назначаются при создании
• Удаление зоны — возможно только когда зона пуста (остаются только NS записи) (ошибка 1009)

Правила записей

• Эксклюзивность CNAME (RFC 1033) — CNAME не может сосуществовать с другими типами с тем же именем (ошибка 1005)
• NS apex заблокирован — NS-записи на вершине зоны управляются системой и не могут быть изменены, удалены или отключены (ошибка 1008)
• Авто-инкремент SOA serial — serial увеличивается при создании/обновлении/удалении записей, если soa_serial_auto = true
• Fallback TTL — если TTL не указан, используется default_ttl зоны

Правила групп адресов

• Уникальность имени — имя группы уникально в зоне (без учёта регистра) (ошибка 1014)
• Уникальность члена — IP-адрес уникален в группе (ошибка 1014)
• Валидация IP — IPv4 для групп типа A, IPv6 для групп типа AAAA (ошибка 1015)
• Лимит primary — максимум 1 primary роль в группе

Формат ID записей

• Записи используют UUID (uuidv7), возвращаются как строки в API
• Зоны, группы и члены используют целочисленные ID

Полный справочник эндпоинтов

Метод	Эндпоинт	Разрешение	Описание
GET	/user	—	Информация о текущем пользователе
GET	/user/tokens	—	Список API токенов
DELETE	/user/tokens/{id}	—	Удаление API токена
GET	/zones	zones:read	Список зон
POST	/zones	zones:edit	Создание зоны
GET	/zones/{id}	zones:read	Детали зоны
PATCH	/zones/{id}	zones:edit	Обновление зоны
DELETE	/zones/{id}	zones:edit	Удаление зоны
GET	/zones/{id}/transfer_acl	zones:read	Список transfer ACL
POST	/zones/{id}/transfer_acl	zones:edit	Добавление записи ACL
DELETE	/zones/{id}/transfer_acl/{acl_id}	zones:edit	Удаление записи ACL
GET	/zones/{id}/dns_records	records:read	Список записей
POST	/zones/{id}/dns_records	records:edit	Создание записи
GET	/zones/{id}/dns_records/{rid}	records:read	Получение записи
PUT	/zones/{id}/dns_records/{rid}	records:edit	Полное обновление записи
PATCH	/zones/{id}/dns_records/{rid}	records:edit	Частичное обновление записи
DELETE	/zones/{id}/dns_records/{rid}	records:edit	Удаление записи
POST	/zones/{id}/dns_records/batch	records:edit	Пакетные операции
GET	/zones/{id}/address_groups	groups:read	Список групп адресов
POST	/zones/{id}/address_groups	groups:edit	Создание группы
GET	/zones/{id}/address_groups/{gid}	groups:read	Детали группы
DELETE	/zones/{id}/address_groups/{gid}	groups:edit	Удаление группы
GET	/zones/{id}/address_groups/{gid}/members	groups:read	Список членов
POST	/zones/{id}/address_groups/{gid}/members	groups:edit	Добавление члена
PATCH	/zones/{id}/address_groups/{gid}/members/{mid}	groups:edit	Обновление члена
DELETE	/zones/{id}/address_groups/{gid}/members/{mid}	groups:edit	Удаление члена
PATCH	/zones/{id}/address_groups/{gid}/policy	groups:edit	Обновление политики LB
GET	/zones/{id}/address_groups/{gid}/health	health:read	Статус здоровья
PATCH	/zones/{id}/address_groups/{gid}/health	health:edit	Настройка здоровья
GET	/zones/{id}/address_groups/{gid}/health_checks	health:read	История проверок
GET	/zones/{id}/address_groups/{gid}/failover_events	health:read	События failover
GET	/zones/{id}/address_groups/{gid}/healthbar	health:read	Сводка здоровья