Selectel API: Управлять DNS-записями домена

Сценарий из mcp-everything. Актуально на 2026-10-24.

Автоматически добавлять поддомены для клиентов, менять записи при переезде, подтверждать домен TXT-записью.

Получи зоны: GET /domains/v2/zones с токеном проекта — найди id своей зоны. Новую зону создаёт POST /domains/v2/zones (имя с точкой в конце).
Добавь запись: POST /domains/v2/zones/{zone_id}/rrset с name (полное имя с точкой в конце), type, ttl (60–604800) и records — списком content.
Найти существующую запись — GET /domains/v2/zones/{zone_id}/rrset с name или search; изменить — PATCH /domains/v2/zones/{zone_id}/rrset/{rrset_id} с ttl и новым records (ответ 204); удалить — DELETE по тому же адресу.

curl -X POST "https://api.selectel.ru/domains/v2/zones/<zone_id>/rrset" \
  -H "X-Auth-Token: $TOKEN" -H 'Content-Type: application/json' \
  -d '{"name": "shop.example.ru.", "type": "A", "ttl": 300, "records": [{"content": "203.0.113.10"}]}'

Базовые URL

Боевой: https://api.selectel.ru
Identity (токены): https://cloud.api.selcloud.ru
Адреса по сервисам: https://api.selectel.ru/vpc/resell/v2

Авторизация

Тип: Другое

IAM-токен аккаунта (iam_token_account_scoped) или проекта (iam_token_project_scoped) — заголовок X-Auth-Token, живёт 24 часа. Получается запросом POST https://cloud.api.selcloud.ru/identity/v3/auth/tokens (метод password: имя сервисного пользователя, ID аккаунта как домен, пароль; scope — domain или project). Токен возвращается в заголовке ответа X-Subject-Token, код 201.
Статический токен (static_token) — заголовок X-Token, без срока действия, только для пользователей панели; не работает с OpenStack API. Нужен для отчётов биллинга, тикетов, учёта IP.

Для рабочих интеграций документация рекомендует сервисных пользователей.

Методы сценария

GET /domains/v2/zones — Список DNS-зон

Параметр	Где	Тип	Обяз.	Описание
`X-Auth-Token`	header	string	да	IAM-токен проекта
`limit`	query	integer	нет	Сколько вернуть, по умолчанию 1000
`offset`	query	integer	нет	Смещение, по умолчанию 0
`filter`	query	string	нет	Фильтр по имени
`sort_by`	query	array	нет	Сортировка, по умолчанию name.ascend

POST /domains/v2/zones — Создание DNS-зоны

Параметр	Где	Тип	Обяз.	Описание
`name`	body	string	да	Доменное имя зоны (оканчивается точкой)

GET /domains/v2/zones/{zone_id}/rrset — Записи зоны

Параметр	Где	Тип	Обяз.	Описание
`zone_id`	path	string	да	UUID зоны
`limit`	query	integer	нет	По умолчанию 1000
`offset`	query	integer	нет	Смещение
`rrset_types`	query	array	нет	Фильтр по типу
`name`	query	string	нет	Фильтр по имени
`search`	query	string	нет	Поиск по имени или содержимому

POST /domains/v2/zones/{zone_id}/rrset — Создание набора записей

Параметр	Где	Тип	Обяз.	Описание
`zone_id`	path	string	да	UUID зоны
`name`	body	string	да	Имя (FQDN с точкой в конце)
`ttl`	body	integer	да	60–604800 секунд
`type`	body	string	да	A, AAAA, ALIAS, CAA, CNAME, DNAME, HTTPS, MX, NS, SOA, SRV, SVCB, SSHFP, TXT
`records`	body	array	да	1–100 записей: content, disabled
`comment`	body	string	нет	Комментарий

PATCH /domains/v2/zones/{zone_id}/rrset/{rrset_id} — Изменение набора записей

Успех — 204.

Параметр	Где	Тип	Обяз.	Описание
`zone_id`	path	string	да	UUID зоны
`rrset_id`	path	string	да	UUID набора записей
`ttl`	body	integer	да	60–604800 секунд
`records`	body	array	да	Новый список записей
`comment`	body	string	нет	Комментарий

Нюансы

Облачные серверы, сети и диски создаются через OpenStack API; Resell API управляет проектами, квотами, публичными IP, подсетями и трафиком.
Методы /v2/keypairs и лицензий в Resell API устарели и будут удалены — для SSH-ключей используйте Nova API.
Имена зон и записей DNS — полные, с точкой в конце.
Для пулов в Центральной Азии и Кении используются хосты *.servercore.com.
У каждого API есть OpenAPI-спецификация в JSON на странице документации (например, https://docs.selectel.ru/api/dns-actual.json).

Другие сценарии

Если этого недостаточно — официальная документация: https://docs.selectel.ru/api/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/selectel.md