# Beget API хостинга: GET /api/domain/addSubdomainVirtual — Добавление поддомена

Возвращает ID поддомена.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `input_format` | query | string | да | json |
| `input_data.subdomain` | query | string | да | Имя поддомена |
| `input_data.domain_id` | query | integer | да | ID родительского домена |

## Базовые URL

- Боевой: `https://api.beget.com`
- Формат вызова: `https://api.beget.com/api/раздел/метод?параметры`

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

Тип: Другое

В каждом запросе передаются `login` (логин аккаунта) и `passwd` (API-пароль, URL-кодированный).

```
https://api.beget.com/api/user/getAccountInfo?login=user&passwd=mypassword
```

## Нюансы

- `input_format`: `plain` (по умолчанию) или `json`; при `json` все аргументы метода передаются в `input_data` JSON-строкой, URL-кодированной.
- Успешный ответ: `{"status": "success", "answer": ...}`; результат метода — в `answer.result`. Ошибка метода приходит внутри успешного ответа: `answer.status` = `error`, массив `answer.errors`.
- Изменения (заморозка сайта, привязка домена, создание БД) выполняются в очереди и применяются через несколько минут.
- Другие разделы: `stat` (статистика), `mail`, `ftp`, `cron`; методы `domain/getSubdomainList`, `deleteSubdomain`, `getDirectives`, `addDirectives`, `site/delete`, `freeze`, `unfreeze`, `mysql/addAccess`, `dropDb`, `backup/getLog` и др.

---

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