{"name":"Timeweb Cloud API","vendor":"Timeweb Cloud","industry":"cloud","summary":"REST API облачной платформы Timeweb Cloud: облачные и выделенные серверы, диски и бэкапы, образы, базы данных, S3-хранилища, Kubernetes, балансировщики, сети (VPC, плавающие IP), домены и DNS, SSH-ключи, проекты, финансы аккаунта. Большинство функций панели управления доступно через API. Описание собрано по OpenAPI-спецификации из официального SDK Timeweb Cloud.","docsUrl":"https://timeweb.cloud/api-docs","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"sozdat-oblachnyy-server-iz-skripta","title":"Создать облачный сервер из скрипта","summary":"Поднять сервер под проект, тест или клиента — с нужной ОС, тарифом и SSH-ключом.","steps":["Создай токен в панели управления (раздел «API и Terraform») и передавай его в заголовке Authorization: Bearer <токен>.","Выбери тариф и ОС: GET /api/v1/presets/servers (server_presets) и GET /api/v1/os/servers (servers_os).","Добавь свой SSH-ключ, если его ещё нет: POST /api/v1/ssh-keys с name, body и is_default. Список ключей — GET /api/v1/ssh-keys.","Создай сервер: POST /api/v1/servers с name, preset_id (или configuration — не оба), os_id, ssh_keys_ids и availability_zone. Ответ 201 с объектом server.","Сервер ещё может запускаться — проверяй status через GET /api/v1/servers/{server_id}, пока он не станет рабочим."],"code":"curl -X POST https://api.timeweb.cloud/api/v1/servers \\\n  -H \"Authorization: Bearer $TIMEWEB_CLOUD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\n        \"name\": \"web-1042\",\n        \"preset_id\": <ID тарифа>,\n        \"os_id\": <ID ОС>,\n        \"ssh_keys_ids\": [<ID ключа>],\n        \"availability_zone\": \"msk-1\",\n        \"is_ddos_guard\": false,\n        \"comment\": \"Сервер для клиента 1042\"\n      }'","language":"bash","methods":["POST /api/v1/servers","GET /api/v1/servers/{server_id}","GET /api/v1/presets/servers","GET /api/v1/os/servers","GET /api/v1/ssh-keys","POST /api/v1/ssh-keys"]},{"id":"perezagruzit-vyklyuchit-ili-izmenit","title":"Перезагрузить, выключить или изменить сервер","summary":"Управление серверами из своей панели или по расписанию.","steps":["Выполни действие: POST /api/v1/servers/{server_id}/action с action — например, reboot, hard_reboot, hard_shutdown. Успех — 204.","Чтобы сменить тариф или ресурсы, вызови PATCH /api/v1/servers/{server_id} с preset_id или configurator (cpu, ram, disk). Тем же методом меняются имя и комментарий.","Список серверов — GET /api/v1/servers с limit и offset; общее число — в meta.total.","Удаление — DELETE /api/v1/servers/{server_id}. Если в аккаунте включено подтверждение удаления, первый вызов вернёт server_delete.hash, а код придёт в Telegram — повтори запрос с hash и code."],"code":"curl -X POST \"https://api.timeweb.cloud/api/v1/servers/<server_id>/action\" \\\n  -H \"Authorization: Bearer $TIMEWEB_CLOUD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"action\": \"reboot\"}'","language":"bash","methods":["GET /api/v1/servers","PATCH /api/v1/servers/{server_id}","DELETE /api/v1/servers/{server_id}","POST /api/v1/servers/{server_id}/action"]},{"id":"dobavit-dns-zapis-domena","title":"Добавить DNS-запись домена","summary":"Поддомены для клиентов, подтверждение домена TXT-записью, почтовые MX-записи.","steps":["Найди домен: GET /api/v1/domains.","Посмотри текущие записи: GET /api/v1/domains/{fqdn}/dns-records.","Добавь запись: POST /api/v1/domains/{fqdn}/dns-records с type (A, AAAA, CNAME, MX, TXT, SRV), value и при необходимости subdomain, priority и ttl."],"code":"curl -X POST \"https://api.timeweb.cloud/api/v1/domains/example.ru/dns-records\" \\\n  -H \"Authorization: Bearer $TIMEWEB_CLOUD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"type\": \"TXT\", \"value\": \"yandex-verification: 0123456789abcdef\"}'","language":"bash","methods":["GET /api/v1/domains","GET /api/v1/domains/{fqdn}/dns-records","POST /api/v1/domains/{fqdn}/dns-records"]},{"id":"sozdat-bazu-dannyh-i-s3-hranilische","title":"Создать базу данных и S3-хранилище","summary":"Управляемая база и хранилище файлов для нового проекта — без ручной настройки в панели.","steps":["Создай кластер БД: POST /api/v1/databases с name, type (например, postgres16), preset_id, admin.login и admin.password, instance.name и availability_zone. Вместе с кластером создаётся и база.","Создай хранилище: POST /api/v1/storages/buckets с name, type (private или public) и preset_id.","Чтобы ресурсы были сгруппированы, создай проект заранее: POST /api/v1/projects — и передавай его project_id.","Следи за расходами: GET /api/v1/account/finances — balance, hourly_cost и monthly_cost."],"code":"curl -X POST https://api.timeweb.cloud/api/v1/databases \\\n  -H \"Authorization: Bearer $TIMEWEB_CLOUD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"name\": \"shop-db\", \"type\": \"postgres16\", \"preset_id\": <ID тарифа БД>,\n       \"admin\": {\"login\": \"shop\", \"password\": \"<пароль>\"}, \"instance\": {\"name\": \"shop\"}, \"availability_zone\": \"msk-1\"}'","language":"bash","methods":["GET /api/v1/account/finances","POST /api/v1/projects","POST /api/v1/databases","POST /api/v1/storages/buckets"]}],"baseUrls":[{"label":"Боевой","url":"https://api.timeweb.cloud"}],"auth":{"type":"bearer","description":"JWT-токен создаётся в панели управления в разделе «API и Terraform» и передаётся в каждом запросе:","example":"  Authorization: Bearer $TIMEWEB_CLOUD_TOKEN"},"methods":[{"id":"GET /api/v1/account/finances","title":"Платёжная информация","httpMethod":"GET","path":"/api/v1/account/finances","description":"В ответе `finances`: `balance`, `currency`, `discount_percent`, `hourly_cost`, `monthly_cost` и др.","params":[{"name":"Authorization","in":"header","type":"string","required":true,"description":"Bearer <токен>"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/projects","title":"Список проектов","httpMethod":"GET","path":"/api/v1/projects","description":"","params":[{"name":"Authorization","in":"header","type":"string","required":true,"description":"Bearer <токен>"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/projects","title":"Создание проекта","httpMethod":"POST","path":"/api/v1/projects","description":"","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Имя проекта, до 255 символов"},{"name":"description","in":"body","type":"string","required":false,"description":"Описание, до 255 символов"},{"name":"avatar_id","in":"body","type":"string","required":false,"description":"ID аватара"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/servers","title":"Список серверов","httpMethod":"GET","path":"/api/v1/servers","description":"В ответе `servers` и `meta.total`.","params":[{"name":"limit","in":"query","type":"integer","required":false,"description":"Сколько записей вернуть"},{"name":"offset","in":"query","type":"integer","required":false,"description":"Смещение от начала списка"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/servers","title":"Создание сервера","httpMethod":"POST","path":"/api/v1/servers","description":"Нужен `preset_id` или `configuration` (одно из двух). Ответ `201` с объектом `server`; сервер может ещё запускаться — смотрите `status`.","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Имя сервера, до 255 символов"},{"name":"preset_id","in":"body","type":"number","required":false,"description":"ID тарифа (нельзя вместе с configuration)"},{"name":"configuration.configurator_id","in":"body","type":"number","required":false,"description":"ID конфигуратора (обязателен внутри configuration)"},{"name":"configuration.disk","in":"body","type":"number","required":false,"description":"Диск, МБ"},{"name":"configuration.cpu","in":"body","type":"number","required":false,"description":"Число ядер"},{"name":"configuration.ram","in":"body","type":"number","required":false,"description":"ОЗУ, МБ"},{"name":"configuration.gpu","in":"body","type":"number","required":false,"description":"Число видеокарт"},{"name":"os_id","in":"body","type":"number","required":false,"description":"ID ОС (нельзя вместе с image_id)"},{"name":"image_id","in":"body","type":"string","required":false,"description":"ID образа"},{"name":"software_id","in":"body","type":"number","required":false,"description":"ID ПО из маркетплейса"},{"name":"bandwidth","in":"body","type":"number","required":false,"description":"Пропускная способность: 100–1000 с шагом 100"},{"name":"is_ddos_guard","in":"body","type":"boolean","required":false,"description":"Защищённый IP (L3/L4)"},{"name":"ssh_keys_ids","in":"body","type":"array","required":false,"description":"SSH-ключи"},{"name":"is_local_network","in":"body","type":"boolean","required":false,"description":"Локальная сеть"},{"name":"network.id","in":"body","type":"string","required":false,"description":"ID приватной сети"},{"name":"network.floating_ip","in":"body","type":"string","required":false,"description":"Публичный IP"},{"name":"network.local_ip","in":"body","type":"string","required":false,"description":"Приватный IP"},{"name":"cloud_init","in":"body","type":"string","required":false,"description":"Cloud-init скрипт"},{"name":"availability_zone","in":"body","type":"string","required":false,"description":"spb-1…spb-4, msk-1, nsk-1, ams-1, ala-1, fra-1"},{"name":"project_id","in":"body","type":"number","required":false,"description":"ID проекта"},{"name":"hostname","in":"body","type":"string","required":false,"description":"Сетевое имя"},{"name":"comment","in":"body","type":"string","required":false,"description":"Комментарий, до 255 символов"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/servers/{server_id}","title":"Получение сервера","httpMethod":"GET","path":"/api/v1/servers/{server_id}","description":"","params":[{"name":"server_id","in":"path","type":"integer","required":true,"description":"ID сервера"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PATCH /api/v1/servers/{server_id}","title":"Изменение сервера","httpMethod":"PATCH","path":"/api/v1/servers/{server_id}","description":"","params":[{"name":"server_id","in":"path","type":"integer","required":true,"description":"ID сервера"},{"name":"preset_id","in":"body","type":"number","required":false,"description":"Новый тариф (нельзя вместе с configurator)"},{"name":"configurator.cpu","in":"body","type":"number","required":false,"description":"Число ядер"},{"name":"configurator.ram","in":"body","type":"number","required":false,"description":"ОЗУ, МБ"},{"name":"configurator.disk","in":"body","type":"number","required":false,"description":"Диск, МБ"},{"name":"os_id","in":"body","type":"number","required":false,"description":"Переустановить ОС"},{"name":"image_id","in":"body","type":"string","required":false,"description":"Установить образ"},{"name":"name","in":"body","type":"string","required":false,"description":"Имя"},{"name":"comment","in":"body","type":"string","required":false,"description":"Комментарий"},{"name":"bandwidth","in":"body","type":"number","required":false,"description":"Пропускная способность"},{"name":"cloud_init","in":"body","type":"string","required":false,"description":"Cloud-init скрипт"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"DELETE /api/v1/servers/{server_id}","title":"Удаление сервера","httpMethod":"DELETE","path":"/api/v1/servers/{server_id}","description":"Если включено подтверждение удаления, первый вызов вернёт `server_delete.hash`, а код придёт в Telegram; повторите запрос с `hash` и `code`.","params":[{"name":"server_id","in":"path","type":"integer","required":true,"description":"ID сервера"},{"name":"hash","in":"query","type":"string","required":false,"description":"Хеш из первого ответа"},{"name":"code","in":"query","type":"string","required":false,"description":"Код подтверждения"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/servers/{server_id}/action","title":"Действие над сервером","httpMethod":"POST","path":"/api/v1/servers/{server_id}/action","description":"Успех — `204`. Есть и отдельные методы `/start`, `/shutdown`, `/reboot`, `/hard-reboot`, `/clone`, `/reset-password`.","params":[{"name":"server_id","in":"path","type":"integer","required":true,"description":"ID сервера"},{"name":"action","in":"body","type":"string","required":true,"description":"hard_reboot, hard_shutdown, install, reboot, remove, reset_password, shutdown, start, clone"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/presets/servers","title":"Тарифы серверов","httpMethod":"GET","path":"/api/v1/presets/servers","description":"В ответе `server_presets`.","params":[{"name":"Authorization","in":"header","type":"string","required":true,"description":"Bearer <токен>"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/os/servers","title":"Операционные системы","httpMethod":"GET","path":"/api/v1/os/servers","description":"В ответе `servers_os`.","params":[{"name":"Authorization","in":"header","type":"string","required":true,"description":"Bearer <токен>"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/ssh-keys","title":"Список SSH-ключей","httpMethod":"GET","path":"/api/v1/ssh-keys","description":"","params":[{"name":"Authorization","in":"header","type":"string","required":true,"description":"Bearer <токен>"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/ssh-keys","title":"Создание SSH-ключа","httpMethod":"POST","path":"/api/v1/ssh-keys","description":"","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Название"},{"name":"body","in":"body","type":"string","required":true,"description":"Тело ключа"},{"name":"is_default","in":"body","type":"boolean","required":true,"description":"Выбирать по умолчанию при создании сервера"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/databases","title":"Создание кластера БД","httpMethod":"POST","path":"/api/v1/databases","description":"Вместе с кластером создаётся инстанс. Ответ — объект `db`.","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Название кластера"},{"name":"type","in":"body","type":"string","required":true,"description":"Тип: mysql, mysql8_4, postgres14…postgres18, valkey7, mongodb7, clickhouse и др."},{"name":"preset_id","in":"body","type":"integer","required":false,"description":"ID тарифа (нельзя вместе с configuration)"},{"name":"configuration.configurator_id","in":"body","type":"integer","required":false,"description":"ID конфигуратора"},{"name":"configuration.disk","in":"body","type":"integer","required":false,"description":"Диск, МБ"},{"name":"configuration.cpu","in":"body","type":"integer","required":false,"description":"Ядра"},{"name":"configuration.ram","in":"body","type":"integer","required":false,"description":"ОЗУ, МБ"},{"name":"admin.login","in":"body","type":"string","required":false,"description":"Пользователь БД"},{"name":"admin.password","in":"body","type":"string","required":false,"description":"Пароль"},{"name":"instance.name","in":"body","type":"string","required":false,"description":"Название базы"},{"name":"network.id","in":"body","type":"string","required":false,"description":"ID сети"},{"name":"replication.count","in":"body","type":"number","required":false,"description":"Число реплик"},{"name":"availability_zone","in":"body","type":"string","required":false,"description":"Зона доступности"},{"name":"project_id","in":"body","type":"integer","required":false,"description":"ID проекта"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/storages/buckets","title":"Создание S3-хранилища","httpMethod":"POST","path":"/api/v1/storages/buckets","description":"","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Название"},{"name":"type","in":"body","type":"string","required":true,"description":"private или public"},{"name":"preset_id","in":"body","type":"number","required":false,"description":"ID тарифа (нельзя вместе с configurator)"},{"name":"configurator.id","in":"body","type":"number","required":false,"description":"ID конфигуратора"},{"name":"configurator.disk","in":"body","type":"number","required":false,"description":"Размер, МБ"},{"name":"description","in":"body","type":"string","required":false,"description":"Комментарий"},{"name":"project_id","in":"body","type":"number","required":false,"description":"ID проекта"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/domains","title":"Список доменов","httpMethod":"GET","path":"/api/v1/domains","description":"","params":[{"name":"limit","in":"query","type":"integer","required":false,"description":"Сколько записей вернуть"},{"name":"offset","in":"query","type":"integer","required":false,"description":"Смещение"},{"name":"idn_name","in":"query","type":"string","required":false,"description":"Интернационализированное имя"},{"name":"linked_ip","in":"query","type":"string","required":false,"description":"Привязанный IP"},{"name":"order","in":"query","type":"string","required":false,"description":"Порядок"},{"name":"sort","in":"query","type":"string","required":false,"description":"Сортировка"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v1/domains/{fqdn}/dns-records","title":"DNS-записи домена","httpMethod":"GET","path":"/api/v1/domains/{fqdn}/dns-records","description":"","params":[{"name":"fqdn","in":"path","type":"string","required":true,"description":"Полное имя домена или поддомена"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Сколько записей вернуть"},{"name":"offset","in":"query","type":"integer","required":false,"description":"Смещение"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v1/domains/{fqdn}/dns-records","title":"Добавление DNS-записи","httpMethod":"POST","path":"/api/v1/domains/{fqdn}/dns-records","description":"","params":[{"name":"fqdn","in":"path","type":"string","required":true,"description":"Полное имя домена"},{"name":"type","in":"body","type":"string","required":true,"description":"TXT, SRV, CNAME, AAAA, MX, A"},{"name":"value","in":"body","type":"string","required":true,"description":"Значение записи"},{"name":"subdomain","in":"body","type":"string","required":false,"description":"Полное имя поддомена"},{"name":"priority","in":"body","type":"number","required":false,"description":"Приоритет"},{"name":"ttl","in":"body","type":"number","required":false,"description":"Время жизни"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[{"title":"","language":"text","code":"  curl -X PATCH \n    -H \"Content-Type: application/json\" \n    -H \"Authorization: Bearer $TIMEWEB_CLOUD_TOKEN\" \n    -d '{\"name\":\"Cute Corvus\",\"comment\":\"Development Server\"}' \n    \"https://api.timeweb.cloud/api/v1/dedicated/1051\""}],"errors":[{"code":"400","description":"Неверный запрос"},{"code":"401","description":"Ошибка аутентификации"},{"code":"403","description":"Недостаточно прав"},{"code":"404","description":"Ресурс не найден"},{"code":"409","description":"Конфликт с текущим состоянием"},{"code":"423","description":"Ресурс заблокирован"},{"code":"429","description":"Превышен лимит запросов"},{"code":"500","description":"Внутренняя ошибка"}],"limits":"- Больше 20 запросов в секунду на одну конечную точку — может вернуться `429 Too Many Requests`.","gotchas":["Тело `POST`, `PUT`, `PATCH` — `application/json`.","Пагинация и поиск в коллекциях: `limit`, `offset`, `search`, `sort`.","Ответы на `GET` содержат объект сущности по ключу, `meta.total` для коллекций и `response_id` (UUIDv4, приложите его в обращении в поддержку).","Созданный ресурс может быть ещё «в состоянии запуска» — проверяйте поле `status`.","Около 380 методов; кроме перечисленных — выделенные серверы, диски и бэкапы, образы, Kubernetes, балансировщики, VPC, плавающие IP, приложения, CDN, реестр контейнеров, ограничения доступа к аккаунту."],"slug":"timeweb-cloud","version":2,"updatedAt":"2026-10-24T17:05:37.900Z","sources":[{"title":"Timeweb Cloud API","url":"https://timeweb.cloud/api-docs","kind":"research","addedAt":"2026-10-19T13:52:38.007Z"},{"title":"OpenAPI-спецификация в официальном SDK — timeweb-cloud/sdk-go","url":"https://github.com/timeweb-cloud/sdk-go","kind":"research","addedAt":"2026-10-19T13:52:38.007Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-19T13:52:38.007Z"},{"title":"scenarios-timeweb-cloud.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:27.869Z"}],"logoUrl":null}