# API-reference

## Авторизация

<mark style="color:green;">`POST`</mark> `https://cp.pureservers.org/api/auth/login`

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                       | Type   | Description |
| ------------------------------------------ | ------ | ----------- |
| email<mark style="color:red;">\*</mark>    | String | E-mail      |
| password<mark style="color:red;">\*</mark> | String | Пароль      |
| region                                     | String | Всегда "UK" |

{% tabs %}
{% tab title="400: Bad Request Не заполнены поля" %}

```json
"FillFields"
```

{% endtab %}

{% tab title="403: Forbidden Пользователь не существует или заблокирован" %}
Пользователь не существует:

```json
"UserNotExists" || "UserBlocked"
```

{% endtab %}

{% tab title="200: OK Авторизация выполнена" %}
В случае успешной авторизации вы получите текст **LoggedIn** и ответный заголовок **session**, который необходимо сохранить и использовать в дальнейших запросах.
{% endtab %}
{% endtabs %}

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

<mark style="color:blue;">`GET`</mark> `https://cp.pureservers.org/api/servers/list`

#### Headers

| Name                                      | Type   | Description                          |
| ----------------------------------------- | ------ | ------------------------------------ |
| session<mark style="color:red;">\*</mark> | String | Заголовок полученный при авторизации |

{% tabs %}
{% tab title="200: OK Успешный запрос" %}

```javascript
[{
    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'],
}]
```

{% endtab %}
{% endtabs %}

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

<mark style="color:green;">`POST`</mark> `https://cp.pureservers.org/api/public/tariffs`

#### Request Body

| Name                                       | Type   | Description     |
| ------------------------------------------ | ------ | --------------- |
| currency<mark style="color:red;">\*</mark> | String | Валюта аккаунта |

{% tabs %}
{% tab title="200: OK Успешный запрос" %}

```javascript
[{
    _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
}]
```

{% endtab %}
{% endtabs %}

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

<mark style="color:green;">`POST`</mark> `https://cp.pureservers.org/api/servers/order`

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

#### Headers

| Name                                           | Type   | Description                          |
| ---------------------------------------------- | ------ | ------------------------------------ |
| session<mark style="color:red;">\*</mark>      | String | Заголовок полученный при авторизации |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json                     |

{% tabs %}
{% tab title="400: Bad Request " %}
Возможные ошибки:

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

{% tab title="403: Forbidden " %}
Возможные ошибки:

WhoAreU - пользователь через которого вы авторизованы не существует;\
NotEnoughFunds - недостаточно средств на балансе.<br>
{% endtab %}

{% tab title="404: Not Found " %}
Возможные ошибки:

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

{% tab title="200: OK " %}
В случае успеха вы получите ObjectId заказанного сервера.
{% endtab %}
{% endtabs %}