{"name":"Beget API хостинга","vendor":"Beget","industry":"cloud","summary":"API виртуального хостинга Beget: информация об аккаунте и тарифе, домены и поддомены, DNS-записи, сайты, базы MySQL, FTP, cron, бэкапы, почта и статистика. Запрос — HTTP-вызов вида «раздел/метод» с логином и API-паролем, ответ — JSON. Для облачных сервисов Beget есть отдельный API с JWT-токенами на `https://developer.beget.com`.","docsUrl":"https://beget.com/ru/kb/api/beget-api","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"sozdat-sayt-i-privyazat-k-nemu-domen","title":"Создать сайт и привязать к нему домен","summary":"Развернуть новый сайт клиента на хостинге: каталог сайта, домен, привязка.","steps":["Задай API-пароль в панели Beget. В каждом запросе передаются login и passwd (URL-кодированный). Формат вызова — https://api.beget.com/api/<раздел>/<метод>.","Для методов с аргументами передавай input_format = json и input_data — JSON-строкой, URL-кодированной. output_format = json вернёт ответ в JSON.","Создай каталог сайта: GET /api/site/add с input_data.name (например, shop.ru) — полный путь будет shop.ru/public_html.","Добавь домен: GET /api/domain/addVirtual с hostname (имя без зоны) и zone_id (ID зоны из GET /api/domain/getZoneList). Метод вернёт ID домена.","Привяжи домен к сайту: GET /api/site/linkDomain с domain_id и site_id. Сайт откроется через 5–10 минут. Ошибки метода приходят внутри успешного ответа: answer.status = error и массив answer.errors."],"code":"AUTH='login=<логин>&passwd=<API-пароль>&output_format=json&input_format=json'\n\ncurl \"https://api.beget.com/api/site/add?$AUTH\" --data-urlencode 'input_data={\"name\": \"shop.ru\"}' -G\ncurl \"https://api.beget.com/api/domain/addVirtual?$AUTH\" --data-urlencode 'input_data={\"hostname\": \"shop\", \"zone_id\": 1}' -G\ncurl \"https://api.beget.com/api/site/linkDomain?$AUTH\" --data-urlencode 'input_data={\"domain_id\": <ID домена>, \"site_id\": <ID сайта>}' -G","language":"bash","methods":["GET /api/domain/getZoneList","GET /api/domain/addVirtual","GET /api/site/add","GET /api/site/linkDomain"]},{"id":"izmenit-dns-zapisi-domena","title":"Изменить DNS-записи домена","summary":"Направить домен на другой сервер, добавить MX для почты или TXT для подтверждения.","steps":["Получи текущие записи: GET /api/dns/getData с input_data.fqdn. В ответе records по типам и set_type.","Отправь новый набор: GET /api/dns/changeRecords с fqdn и records — одной группой: A, MX и TXT (до 10 каждого), или NS (только для поддоменов), или CNAME (только поддомен, одна запись). У каждой записи priority и value.","Метод заменяет группу записей целиком — передавай все записи, которые должны остаться, а не только новые."],"code":"curl -G \"https://api.beget.com/api/dns/changeRecords?login=<логин>&passwd=<API-пароль>&input_format=json&output_format=json\" \\\n  --data-urlencode 'input_data={\"fqdn\": \"shop.ru\", \"records\": {\n      \"A\": [{\"priority\": 10, \"value\": \"203.0.113.10\"}],\n      \"MX\": [{\"priority\": 10, \"value\": \"mx1.beget.com\"}, {\"priority\": 20, \"value\": \"mx2.beget.com\"}],\n      \"TXT\": [{\"priority\": 10, \"value\": \"v=spf1 redirect=beget.com\"}]}}'","language":"bash","methods":["GET /api/dns/getData","GET /api/dns/changeRecords"]},{"id":"sozdat-bazu-mysql-dlya-sayta","title":"Создать базу MySQL для сайта","summary":"База для нового сайта или CMS.","steps":["Создай базу: GET /api/mysql/addDb с suffix (имя будет логин_суффикс, не длиннее 16 символов) и password (от 6 символов). Создаётся доступ с localhost.","Создание идёт в очереди и занимает несколько минут — проверь, что база появилась: GET /api/mysql/getList.","Лимит API — 60 запросов в минуту на пользователя."],"code":"curl -G \"https://api.beget.com/api/mysql/addDb?login=<логин>&passwd=<API-пароль>&input_format=json&output_format=json\" \\\n  --data-urlencode 'input_data={\"suffix\": \"shop\", \"password\": \"<пароль базы>\"}'","language":"bash","methods":["GET /api/mysql/getList","GET /api/mysql/addDb"]},{"id":"proverit-akkaunt-i-vosstanovit-fayly","title":"Проверить аккаунт и восстановить файлы из бэкапа","summary":"Мониторинг тарифа и баланса и восстановление сайта после неудачного обновления.","steps":["Состояние аккаунта: GET /api/user/getAccountInfo — тариф, баланс, дни до блокировки, использование лимитов. Значение лимита 2147483647 означает «без ограничений».","Найди бэкап: GET /api/backup/getFileBackupList — backup_id и date.","Восстанови нужные пути: GET /api/backup/restoreFile с backup_id и paths — путями от корня домашней директории. Восстановление выполняется в очереди."],"code":"curl -G \"https://api.beget.com/api/backup/restoreFile?login=<логин>&passwd=<API-пароль>&input_format=json&output_format=json\" \\\n  --data-urlencode 'input_data={\"backup_id\": <ID бэкапа>, \"paths\": [\"shop.ru/public_html/wp-content\"]}'","language":"bash","methods":["GET /api/user/getAccountInfo","GET /api/backup/getFileBackupList","GET /api/backup/restoreFile"]}],"baseUrls":[{"label":"Боевой","url":"https://api.beget.com"},{"label":"Формат вызова","url":"https://api.beget.com/api/раздел/метод?параметры"}],"auth":{"type":"other","description":"В каждом запросе передаются `login` (логин аккаунта) и `passwd` (API-пароль, URL-кодированный).","example":"https://api.beget.com/api/user/getAccountInfo?login=user&passwd=mypassword"},"methods":[{"id":"GET /api/user/getAccountInfo","title":"Информация об аккаунте","httpMethod":"GET","path":"/api/user/getAccountInfo","description":"Тариф, баланс, дни до блокировки, использование и лимиты (сайты, домены, MySQL, квота, FTP, почта), параметры сервера и версии ПО. Значение лимита `2147483647` означает «без ограничений».","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"},{"name":"output_format","in":"query","type":"string","required":false,"description":"json (по умолчанию)"}],"requestExample":"https://api.beget.com/api/user/getAccountInfo?login=userlogin&passwd=password&output_format=json","responseExample":"","docsUrl":""},{"id":"GET /api/user/toggleSsh","title":"Включение и отключение SSH","httpMethod":"GET","path":"/api/user/toggleSsh","description":"","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"},{"name":"status","in":"query","type":"integer","required":true,"description":"1 — включить, 0 — выключить"},{"name":"ftplogin","in":"query","type":"string","required":false,"description":"Логин FTP-аккаунта; без него — основной аккаунт"}],"requestExample":"https://api.beget.com/api/user/toggleSsh?login=userlogin&passwd=password&status=1&ftplogin=ftploginname&output_format=json","responseExample":"","docsUrl":""},{"id":"GET /api/domain/getList","title":"Список доменов","httpMethod":"GET","path":"/api/domain/getList","description":"В `result`: `id`, `fqdn`, `date_add`, `auto_renew`, `date_register`, `date_expire`, `can_renew`, `registrar`, `is_under_control` и др.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/domain/getZoneList","title":"Доменные зоны и цены","httpMethod":"GET","path":"/api/domain/getZoneList","description":"В `result`: `id`, `zone`, `price`, `price_renew`, `is_idn`, `min_period`, `max_period` и др.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/domain/addVirtual","title":"Добавление домена","httpMethod":"GET","path":"/api/domain/addVirtual","description":"Возвращает ID домена.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.hostname","in":"query","type":"string","required":true,"description":"Имя домена без зоны"},{"name":"input_data.zone_id","in":"query","type":"integer","required":true,"description":"ID зоны"}],"requestExample":"https://api.beget.com/api/domain/addVirtual?login=userlogin&passwd=password&input_format=json&output_format=json&input_data={\"hostname\":\"domain\",\"zone_id\": 1}","responseExample":"","docsUrl":""},{"id":"GET /api/domain/delete","title":"Удаление домена","httpMethod":"GET","path":"/api/domain/delete","description":"Снимает привязку к сайту и удаляет поддомены.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.id","in":"query","type":"integer","required":true,"description":"ID домена"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/domain/addSubdomainVirtual","title":"Добавление поддомена","httpMethod":"GET","path":"/api/domain/addSubdomainVirtual","description":"Возвращает ID поддомена.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.subdomain","in":"query","type":"string","required":true,"description":"Имя поддомена"},{"name":"input_data.domain_id","in":"query","type":"integer","required":true,"description":"ID родительского домена"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/domain/checkDomainToRegister","title":"Проверка возможности регистрации","httpMethod":"GET","path":"/api/domain/checkDomainToRegister","description":"Регистрация возможна, если `may_be_registered` = `true`, `pay_type` = `money` или `bonus_domain`, `in_system` = `false`.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.hostname","in":"query","type":"string","required":true,"description":"Имя без зоны"},{"name":"input_data.zone_id","in":"query","type":"integer","required":true,"description":"ID зоны из getZoneList"},{"name":"input_data.period","in":"query","type":"integer","required":true,"description":"Срок регистрации в годах"}],"requestExample":"https://api.beget.com/api/domain/checkDomainToRegister?login=userlogin&passwd=password&input_format=json&output_format=json&input_data={\"hostname\": \"domain\", \"zone_id\": 3, \"period\":1}","responseExample":"","docsUrl":""},{"id":"GET /api/domain/changePhpVersion","title":"Смена версии PHP","httpMethod":"GET","path":"/api/domain/changePhpVersion","description":"","params":[{"name":"full_fqdn","in":"query","type":"string","required":true,"description":"Полное имя домена"},{"name":"php_version","in":"query","type":"string","required":true,"description":"Новая версия PHP"},{"name":"is_cgi","in":"query","type":"boolean","required":false,"description":"Режим CGI, по умолчанию false"}],"requestExample":"https://api.beget.com/api/domain/changePhpVersion?login=userlogin&passwd=password&full_fqdn=example.com&php_version=5.4&is_cgi=true&output_format=json","responseExample":"","docsUrl":""},{"id":"GET /api/dns/getData","title":"DNS-записи домена","httpMethod":"GET","path":"/api/dns/getData","description":"В `result`: `is_under_control`, `is_beget_dns`, `is_subdomain`, `fqdn`, `records` (по типам `DNS`, `DNS_IP`, `A`, `MX`, `TXT`; у записи `value` и `priority`), `set_type` (1 — A/MX/TXT, 2 — NS, 3 — CNAME).","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.fqdn","in":"query","type":"string","required":true,"description":"Полное имя домена"}],"requestExample":"https://api.beget.com/api/dns/getData?login=userlogin&passwd=password&input_format=json&output_format=json&input_data={\"fqdn\":\"beget.ru\"}","responseExample":"","docsUrl":""},{"id":"GET /api/dns/changeRecords","title":"Изменение DNS-записей","httpMethod":"GET","path":"/api/dns/changeRecords","description":"Передаётся одна группа записей: A/MX/TXT (до 10 каждого типа), NS (только поддомены, до 10), CNAME (только поддомены, одна запись) или DNS (до 4, для доменов на Beget). У каждой записи `priority` и `value`.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.fqdn","in":"query","type":"string","required":true,"description":"Полное имя домена"},{"name":"input_data.records","in":"query","type":"object","required":true,"description":"Записи по типам"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/site/getList","title":"Список сайтов","httpMethod":"GET","path":"/api/site/getList","description":"В `result`: `id`, `path`, `domains` (`id`, `fqdn`, `php_version`, `ssl` и др.).","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/site/add","title":"Создание сайта","httpMethod":"GET","path":"/api/site/add","description":"Полный путь сайта — `name/public_html`.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.name","in":"query","type":"string","required":true,"description":"Имя директории сайта, например site.ru"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/site/linkDomain","title":"Привязка домена к сайту","httpMethod":"GET","path":"/api/site/linkDomain","description":"Сайт начнёт открываться через 5–10 минут.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.domain_id","in":"query","type":"integer","required":true,"description":"ID домена"},{"name":"input_data.site_id","in":"query","type":"integer","required":true,"description":"ID сайта"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/mysql/getList","title":"Базы MySQL","httpMethod":"GET","path":"/api/mysql/getList","description":"В `result`: `name`, `size`, `accesses[].name`.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/mysql/addDb","title":"Создание базы MySQL","httpMethod":"GET","path":"/api/mysql/addDb","description":"Создание ставится в очередь и может занять несколько минут; создаётся доступ `localhost`.","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.suffix","in":"query","type":"string","required":true,"description":"Суффикс имени; login_suffix — не больше 16 символов"},{"name":"input_data.password","in":"query","type":"string","required":true,"description":"Пароль, от 6 символов"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/backup/getFileBackupList","title":"Список файловых бэкапов","httpMethod":"GET","path":"/api/backup/getFileBackupList","description":"В ответе: `backup_id`, `date`.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"passwd","in":"query","type":"string","required":true,"description":"API-пароль"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/backup/restoreFile","title":"Восстановление файлов из бэкапа","httpMethod":"GET","path":"/api/backup/restoreFile","description":"","params":[{"name":"input_format","in":"query","type":"string","required":true,"description":"json"},{"name":"input_data.backup_id","in":"query","type":"integer","required":true,"description":"ID бэкапа"},{"name":"input_data.paths","in":"query","type":"array","required":true,"description":"Пути от корня домашней директории"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"AUTH_ERROR","description":"Ошибка авторизации"},{"code":"INCORRECT_REQUEST","description":"Некорректный запрос"},{"code":"NO_SUCH_METHOD","description":"Метод не существует"},{"code":"INVALID_DATA","description":"Неверные данные (ошибка метода)"},{"code":"LIMIT_ERROR","description":"Превышен лимит запросов"},{"code":"METHOD_FAILED","description":"Метод не выполнен"}],"limits":"- Не больше 60 запросов в минуту на пользователя.","gotchas":["`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` и др."],"slug":"beget","version":2,"updatedAt":"2026-10-24T17:05:31.527Z","sources":[{"title":"Beget API","url":"https://beget.com/ru/kb/api/beget-api","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Общий принцип работы с API","url":"https://beget.com/ru/kb/api/obshhij-princzip-raboty-s-api","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Управление аккаунтом","url":"https://beget.com/ru/kb/api/funkczii-upravleniya-akkauntom","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Домены","url":"https://beget.com/ru/kb/api/funkczii-dlya-raboty-s-domenami","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"DNS","url":"https://beget.com/ru/kb/api/funkczii-upravleniya-dns","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Сайты","url":"https://beget.com/ru/kb/api/funkczii-upravleniya-sajtami","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"MySQL","url":"https://beget.com/ru/kb/api/funkczii-upravleniya-mysql","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Бэкапы","url":"https://beget.com/ru/kb/api/funkczii-upravleniya-bekapami","kind":"research","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-19T13:53:38.276Z"},{"title":"scenarios-beget.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:23.395Z"}],"logoUrl":null}