API-reference

Описание API

Авторизация

POST https://cp.pureservers.org/api/auth/login

Headers

Name	Type	Description
Content-Type*	String	application/json

Request Body

Name	Type	Description
email*	String	E-mail
password*	String	Пароль

400: Bad Request Не заполнены поля

"FillFields"

403: Forbidden Пользователь не существует или заблокирован

Пользователь не существует:

"UserNotExists" || "UserBlocked"

200: OK Авторизация выполнена

В случае успешной авторизации вы получите текст LoggedIn и ответный заголовок session, который необходимо сохранить и использовать в дальнейших запросах.

Получить список серверов

GET https://cp.pureservers.org/api/servers/list

Headers

Name	Type	Description
session*	String	Заголовок полученный при авторизации

200: OK Успешный запрос

[{
    num_id: String, // Server ID
    user_id: String, // User ID
    os: String, // Operating System name
    ip: string, // Primary IPv4
    username: String, // Username, for linux: root
    password: String, // Password
    tariff_id: String, // Tariff ID
    expires_at: Date, // Expiration date
    // Current server state
    state: {
        cpu: Number, // CPU load
        ram: Number, // Current RAM load
        max_ram: Number, // Max RAM load
        disk: Number, // Current disk load
        max_disk: Number, // Max disk load
    },
    // Status: String, in array you can see available statuses
    status: ['order_processing', 'installation', 'active', 'expired', 'blocked', 'paused'],
}]

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

POST https://cp.pureservers.org/api/public/tariffs

Request Body

Name	Type	Description
currency*	String	Валюта аккаунта

200: OK Успешный запрос

[{
    _id: String, // Tariff ID
    visible_name: String, // Visible tariff name
    cpu: Number, // CPU
    ram: Number, // RAM
    disk: Number, // Disk
    network_speed: Number, // Network speed (mbps)
    price: Number // Price in selected currency
}]

Заказать сервер

POST https://cp.pureservers.org/api/servers/order

В контенте запроса нужно отправить

Headers

Name	Type	Description
session*	String	Заголовок полученный при авторизации
Content-Type*	String	application/json

400: Bad Request

Возможные ошибки:

NoData - вы не отправили ID тарифа; NoIpsAvailable - нет доступных IP-адресов; NoOsAvailable - нет доступных ОС на узле; FailedToCreateServer - не удалось создать сервер.

403: Forbidden

Возможные ошибки:

WhoAreU - пользователь через которого вы авторизованы не существует; NotEnoughFunds - недостаточно средств на балансе.

404: Not Found

Возможные ошибки:

NoTariff - тариф не существует; NoNodes - нет доступных узлов.

200: OK

В случае успеха вы получите ObjectId заказанного сервера.

Получение списка ОС для переустановки

POST https://cp.pureservers.org/api/servers/get-reinstall-oses

В теле запроса необходимо отправить ObjectId сервера для получения доступных ОС.

Headers

Name	Type	Description
session*	String	Заголовок полученный при авторизации
Content-Type*	String	application/json

400: Bad Request

Возможные ошибки:

NoData - вы не отправили нужные данные; ServerUnavailable - не удалось найти сервер или сервер недоступен.

200: OK

В случае успеха вы получите массив следующего формата:

[{
    label: String,
    image: String
}]

Переустановка ОС

POST https://cp.pureservers.org/api/servers/reinstall

Headers

Name	Type	Description
session*	String	Заголовок полученный при авторизации
Content-Type*	String	application/json

Request Body

Name	Type	Description
server_id*	String	ObjectId сервера
os*	String	Операционная система

400: Bad Request

Возможные ошибки:

NoData - не отправлены данные; ServerUnavailable - сервер недоступен или не найден.

200: OK

В случае успеха вы получите текст "Reinstalled".

Перезапустить/остановить/запустить сервер.

POST https://cp.pureservers.org/api/servers/{restart/stop/start}

В теле запросе необходимо отправить ObjectId сервера.

Headers

Name	Type	Description
session*	String	Заголовок полученный при авторизации
Content-Type*	String	application/json

400: Bad Request

Возможные ошибки:

NoData - вы не отправили ID сервера; ServerUnavailable - сервер не найден или недоступен.

200: OK

В случае успеха вы получите код 200 и текст "Requested".