turknode.cloud/docs/api

API

У каждого действия в панели есть эндпоинт. Создайте токен, отправьте JSON — получите JSON.

Основы

Базовый URL: https://api.turknode.cloud/v1
Авторизация: Authorization: Bearer YOUR_TOKEN — токены создаются в панели в разделе Developer → API Keys
Токены: До 10 на аккаунт, отзыв в любой момент
Лимит запросов: 120 запросов в минуту на аккаунт
Оплата: Серверы, заказанные через API, оплачиваются с баланса
Заголовки: Отправляйте Accept: application/json и собственный User-Agent

Список тарифов

При заказе используйте id тарифа.

curl https://api.turknode.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

Создание сервера

Пароль root — 8–12 символов: строчная буква, заглавная буква, цифра и один из символов ! # + $ * -.

curl -X POST https://api.turknode.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Эндпоинты

Аккаунт и каталог

GET	/v1/account	Ваш аккаунт, баланс и скидка реселлера
GET	/v1/plans	Доступные тарифы с ценами
GET	/v1/os	Операционные системы для установки

Серверы

GET	/v1/servers	Список ваших серверов
POST	/v1/servers	Создать сервер
GET	/v1/servers/{id}	Данные сервера
PATCH	/v1/servers/{id}	Переименовать сервер
DELETE	/v1/servers/{id}	Отменить сервер; неиспользованное время возвращается на баланс
POST	/v1/servers/{id}/start	Запустить
POST	/v1/servers/{id}/stop	Остановить
POST	/v1/servers/{id}/restart	Перезагрузить
POST	/v1/servers/{id}/rebuild	Переустановить с другой системой
POST	/v1/servers/{id}/reset-password	Задать новый пароль root
POST	/v1/servers/{id}/request-ip-change	Запросить замену IP
GET	/v1/servers/{id}/upgrade-options	Тарифы, на которые можно перейти
POST	/v1/servers/{id}/upgrade	Перейти на более мощный тариф
POST	/v1/servers/{id}/vnc	Открыть консоль в браузере

Баланс и счета

GET	/v1/wallet	Баланс
GET	/v1/wallet/transactions	Операции по балансу
GET	/v1/invoices	Список счетов
GET	/v1/invoices/{id}	Данные счёта

Тикеты поддержки

GET	/v1/tickets	Список тикетов
POST	/v1/tickets	Создать тикет
GET	/v1/tickets/{id}	Тикет со всеми сообщениями
POST	/v1/tickets/{id}/reply	Ответить в тикет
POST	/v1/tickets/{id}/close	Закрыть тикет

Ошибки

401 Unauthenticated

Токен неверный или отозван. Создайте новый в разделе Developer → API Keys.

403 с ошибкой 1010

Ваша HTTP-библиотека отправляет User-Agent по умолчанию, который блокирует наш файрвол (Python urllib, Perl LWP). Задайте собственный заголовок User-Agent или используйте requests / httpx.

422 Unprocessable

Одно из полей некорректно; в JSON-ответе перечислены поля и причины.

429 Too Many Requests

Превышен лимит 120 запросов в минуту. Подождите и повторите.

Продаёте через WHMCS?

Наш бесплатный модуль работает с этим API за вас.

Модуль WHMCS