VPS.org API

Документация по REST API

Документация по API VPS.org

Полная документация по REST API для управления VPS-серверами, доменами, DNS, резервным копированием и многим другим.

Базовый URL https://admin.vps.org/api/v1
Аутентификация Токен предъявителя
Версия v1.0
Формат JSON

Начиная

API VPS.org позволяет программно управлять всеми аспектами вашей инфраструктуры VPS-хостинга, включая серверы, домены, DNS-записи, резервные копии и снимки.

Аутентификация

Для всех запросов к API требуется аутентификация с использованием токена Bearer. Вы можете сгенерировать свой API-токен в настройках своей учетной записи по адресу [ссылка на настройки учетной записи]. admin.vps.org/account/developers/.

cURL
Python
JavaScript
curl -X GET https://admin.vps.org/api/v1/servers/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Ограничение скорости

Количество запросов к API ограничено 300 запросами за 5 минут на один API-токен. Информация об ограничении скорости запросов содержится в заголовках ответа:

Обработка ошибок

API использует стандартные коды состояния HTTP для обозначения успеха или неудачи:

Код состояния Описание
200 Успех - Запрос успешно выполнен
201 Создано - Ресурс успешно создан
400 Неверный запрос — недопустимые параметры или некорректный формат запроса.
401 Несанкционированный доступ — недействительный или отсутствующий токен аутентификации.
403 Запрещено — Недостаточные права доступа
404 Ресурс не найден.
429 Слишком много запросов — превышен лимит запросов.
500 Внутренняя ошибка сервера — на нашей стороне произошла ошибка.

Категории API

Просмотрите нашу документацию по API по категориям:

API серверов 9 конечных точек

Создавайте, управляйте и контролируйте VPS-серверы. Включает управление питанием, изменение размера, переустановку и получение информации о сервере.

Просмотреть документацию
API резервного копирования 3 конечные точки

Управляйте автоматическим и ручным резервным копированием ваших серверов. Создавайте, восстанавливайте и удаляйте резервные копии серверов.

Просмотреть документацию
API снимков 4 конечные точки

Создавайте и управляйте снимками серверов для быстрого восстановления. Идеально подходит для тестирования и оперативного отката.

Просмотреть документацию
API планов 2 конечные точки

Получите доступ к доступным тарифным планам VPS и информации о ценах. Узнайте подробности о ресурсах, ценах и доступности.

Просмотреть документацию
API операционных систем 2 конечные точки

Список доступных операционных систем и образов для развертывания на сервере. Включает Ubuntu, Debian, CentOS и другие.

Просмотреть документацию
API доменов 6 конечных точек

Поиск, проверка доступности, регистрация и управление доменными именами. Полное управление жизненным циклом домена через API.

Просмотреть документацию
API DNS 4 конечные точки

Программное управление зонами и записями DNS. Создание, обновление и удаление записей типов A, AAAA, CNAME, MX, TXT и других.

Просмотреть документацию
API местоположений 1 конечная точка

Список доступных местоположений центров обработки данных для развертывания серверов. Выберите один из множества регионов по всему миру.

Просмотреть документацию

Нужна помощь?

Если у вас возникнут вопросы или потребуется помощь с API, пожалуйста, не стесняйтесь обращаться к нам: