traffic_plans.php¶

Модуль управления тарифными планами трафика: просмотр доступных планов с учетом параметров сервера или локации, добавление, удаление и обновление планов

Методы API¶

Метод	Действие	Описание
`list`	получение списка тарифов	Возвращает список тарифных планов, подходящих для конкретного сервера (по ID) или доступных в определенной локации.

traffic_plans/list¶

Возвращает список тарифных планов, подходящих для конкретного сервера (по ID) или доступных в определенной локации.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
id	❌	integer	ID сервера для подбора подходящих тарифов.
location	❌	string	Локация (название или ID) для получения всех доступных планов в этом регионе.
vm	❌	integer	Флаг наличия виртуальной машины (1 — да, 0 — нет).
bm	❌	integer	Флаг наличия выделенного сервера (1 — да, 0 — нет).
gpu	❌	integer	Флаг наличия графического процессора (1 — да, 0 — нет).
vgpu	❌	integer	Флаг наличия виртуального графического процессора (1 — да, 0 — нет).
ten_gig	❌	integer	Флаг наличия интерфейса со скоростью 10 Гбит/с.
exclude_list	❌	`array<string>`	Список ID тарифных планов, которые необходимо исключить из выдачи.
all_tags	❌	`array<string>`	Набор тегов для фильтрации тарифных планов.
email	❌	string	Email пользователя для проверки приватности тарифов.
traffic_plans	✅	`array`	Параметр `traffic_plans`
instance	❌	integer	Идентификатор пресета для фильтрации подходящих тарифных планов.

Пример запроса

curl -s "https://invapi.hostkey.ru/traffic_plans.php" -X POST \
--data "action=list" \
--data "id=123" \
--data "location=NL" \
--data "exclude_list[]=10" \
--data "exclude_list[]=11" \
--data "traffic_plans[]=plan1"

Пример успешного ответа

{
"result": "OK",
"action": "list",
"traffic_plans": [
{
"id": 123,
"name": "Standard Plan",
"active": true,
"location": "NL",
"locations": "Amsterdam",
"price": 49.99,
"billing_plan": {
"EUR": 49.99,
"USD": 58.78
},
"limit_in": 1000,
"limit_out": 1000,
"rate_in": 0.01,
"rate_out": 0.02,
"bandwidth": 1000,
"currency_id": 0,
"tags": [
{
"tag": "vds",
"value": "true"
}
]
}
]
}

Примеры ошибок

{
"code": -1,
"message": "$module/$action: location or server id required"
}