API
Всё, что вы делаете в панели, можно делать из своего кода: заказывать и управлять серверами, смотреть баланс и счета, писать в поддержку.
Основное
- Базовый URL
- https://api.turkishvps.com/v1
- Аутентификация
- Передавайте токен как Authorization: Bearer YOUR_TOKEN. Создайте его в панели: Developer → API Keys.
- Токены
- До 10 токенов на аккаунт, отзыв в любой момент.
- Лимит
- 120 запросов в минуту на аккаунт.
- Оплата
- Серверы, заказанные через API, оплачиваются с баланса, как и в панели.
- Формат
- Запросы и ответы в JSON. Передавайте Accept: application/json.
Первый запрос
Получите список тарифов. При заказе укажите id тарифа.
curl https://api.turkishvps.com/v1/plans \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"Заказ сервера
Пароль root: 8–12 символов, строчная и заглавная буква, цифра и один из символов ! # + $ * -.
curl -X POST https://api.turkishvps.com/v1/servers \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'Методы
Аккаунт и каталог
| GET | /account | Аккаунт, баланс и скидка реселлера |
| GET | /plans | Тарифы в продаже с ценами |
| GET | /os | Доступные операционные системы |
Серверы
| GET | /servers | Список серверов |
| POST | /servers | Заказать сервер |
| GET | /servers/{id} | Данные сервера |
| PATCH | /servers/{id} | Переименовать сервер |
| DELETE | /servers/{id} | Удалить сервер (остаток на баланс) |
| POST | /servers/{id}/start | Запустить |
| POST | /servers/{id}/stop | Остановить |
| POST | /servers/{id}/restart | Перезагрузить |
| POST | /servers/{id}/rebuild | Переустановить систему |
| POST | /servers/{id}/reset-password | Новый пароль root |
| POST | /servers/{id}/request-ip-change | Запросить замену IP |
| GET | /servers/{id}/upgrade-options | Доступные апгрейды |
| POST | /servers/{id}/upgrade | Апгрейд тарифа |
| POST | /servers/{id}/vnc | Открыть консоль в браузере |
Баланс и счета
| GET | /wallet | Баланс |
| GET | /wallet/transactions | Операции по балансу |
| GET | /invoices | Список счетов |
| GET | /invoices/{id} | Данные счёта |
Тикеты
| GET | /tickets | Список тикетов |
| POST | /tickets | Открыть тикет |
| GET | /tickets/{id} | Тикет с сообщениями |
| POST | /tickets/{id}/reply | Ответить в тикете |
| POST | /tickets/{id}/close | Закрыть тикет |
Ошибки
Неудачный запрос возвращает статус 4xx и JSON с сообщением; ошибки валидации перечислены по полям.
HTTP/1.1 422 Unprocessable Content
{
"message": "The root password field format is invalid.",
"errors": { "root_password": ["The root password field format is invalid."] }
}Продаёте серверы через WHMCS?
Наш бесплатный модуль WHMCS работает через этот API: заказы, приостановка, апгрейды и цены в вашей валюте.
От регистрации до SSH
Создайте аккаунт
Зарегистрируйтесь по email и подтвердите его.
Пополните баланс
Картой или USDT/TRX в сети TRC20.
Закажите сервер
Выберите тариф и систему. Обычно сервер готов через несколько минут, пароль root или Administrator появится в панели.