# Timeweb Cloud API: Добавить DNS-запись домена

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

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

1. Найди домен: GET /api/v1/domains.
2. Посмотри текущие записи: GET /api/v1/domains/{fqdn}/dns-records.
3. Добавь запись: POST /api/v1/domains/{fqdn}/dns-records с type (A, AAAA, CNAME, MX, TXT, SRV), value и при необходимости subdomain, priority и ttl.

```bash
curl -X POST "https://api.timeweb.cloud/api/v1/domains/example.ru/dns-records" \
  -H "Authorization: Bearer $TIMEWEB_CLOUD_TOKEN" -H 'Content-Type: application/json' \
  -d '{"type": "TXT", "value": "yandex-verification: 0123456789abcdef"}'
```

## Базовые URL

- Боевой: `https://api.timeweb.cloud`

## Авторизация

Тип: Bearer-токен

JWT-токен создаётся в панели управления в разделе «API и Terraform» и передаётся в каждом запросе:

```
Authorization: Bearer $TIMEWEB_CLOUD_TOKEN
```

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

### GET /api/v1/domains — Список доменов

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `limit` | query | integer | нет | Сколько записей вернуть |
| `offset` | query | integer | нет | Смещение |
| `idn_name` | query | string | нет | Интернационализированное имя |
| `linked_ip` | query | string | нет | Привязанный IP |
| `order` | query | string | нет | Порядок |
| `sort` | query | string | нет | Сортировка |

### GET /api/v1/domains/{fqdn}/dns-records — DNS-записи домена

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `fqdn` | path | string | да | Полное имя домена или поддомена |
| `limit` | query | integer | нет | Сколько записей вернуть |
| `offset` | query | integer | нет | Смещение |

### POST /api/v1/domains/{fqdn}/dns-records — Добавление DNS-записи

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `fqdn` | path | string | да | Полное имя домена |
| `type` | body | string | да | TXT, SRV, CNAME, AAAA, MX, A |
| `value` | body | string | да | Значение записи |
| `subdomain` | body | string | нет | Полное имя поддомена |
| `priority` | body | number | нет | Приоритет |
| `ttl` | body | number | нет | Время жизни |

## Нюансы

- Тело `POST`, `PUT`, `PATCH` — `application/json`.
- Пагинация и поиск в коллекциях: `limit`, `offset`, `search`, `sort`.
- Ответы на `GET` содержат объект сущности по ключу, `meta.total` для коллекций и `response_id` (UUIDv4, приложите его в обращении в поддержку).
- Созданный ресурс может быть ещё «в состоянии запуска» — проверяйте поле `status`.
- Около 380 методов; кроме перечисленных — выделенные серверы, диски и бэкапы, образы, Kubernetes, балансировщики, VPC, плавающие IP, приложения, CDN, реестр контейнеров, ограничения доступа к аккаунту.

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

- [Создать облачный сервер из скрипта](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/sozdat-oblachnyy-server-iz-skripta.md)
- [Перезагрузить, выключить или изменить сервер](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/perezagruzit-vyklyuchit-ili-izmenit.md)
- [Создать базу данных и S3-хранилище](https://mcp-everything.ru/integrations/timeweb-cloud/scenarios/sozdat-bazu-dannyh-i-s3-hranilische.md)

---

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