traffic_plans.php¶

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

Методы API¶

Метод	Действие	Описание
`list`	получение списка тарифных планов	Возвращает список подходящих тарифных планов трафика для указанного сервера (id) или локации (location). Поддерживает фильтрацию по типу оборудования и конвертацию цен в EUR/USD/RUB.

traffic_plans/list¶

Возвращает список подходящих тарифных планов трафика для указанного сервера (id) или локации (location). Поддерживает фильтрацию по типу оборудования и конвертацию цен в EUR/USD/RUB.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
id	❌	int	ID сервера для подбора подходящих тарифных планов
location	❌	string	Код локации (дата-центра) для фильтрации планов
instance	❌	int	ID пресета для получения списка планов, совместимых с конфигурацией пресета
vm	✅	string	Параметр `vm` (обнаружен в коде)
traffic_plans	✅	array<array>	Параметр `traffic_plans` (обнаружен в коде)
all_tags	✅	array<array>	Параметр `all_tags` (обнаружен в коде)
exclude_list	✅	string	Параметр `exclude_list` (обнаружен в коде)
email	✅	string	Параметр `email` (обнаружен в коде)

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

curl -s "https://invapi.hostkey.ru/traffic_plans" -X POST \
--data "action=list" \
--data "vm=VALUE" \
--data "traffic_plans[]=VALUE" \
--data "traffic_plans[]=VALUE2" \
--data "all_tags[]=VALUE" \
--data "all_tags[]=VALUE2" \
--data "exclude_list=VALUE" \
--data "email=VALUE"

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

{
"result": "OK",
"action": "list",
"traffic_plans": [
  {
    "id": 101,
    "name": "Standard 100G",
    "active": 1,
    "location": "AMS",
    "locations": "AMS,LDN",
    "limit_in": 100000,
    "limit_out": 100000,
    "rate_in": 1000,
    "rate_out": 1000,
    "bandwidth": 1000,
    "currency_id": 0,
    "price": 49.99,
    "web_plan": 0,
    "main_plan": 1,
    "billing_plan": {
      "EUR": 49.99,
      "USD": 58.99,
      "RUB": 5000.0
    }
  },
  {
    "id": 102,
    "name": "Premium Unlimited",
    "active": 1,
    "location": "AMS",
    "locations": "AMS",
    "limit_in": -1,
    "limit_out": -1,
    "rate_in": 10000,
    "rate_out": 10000,
    "bandwidth": 10000,
    "currency_id": 0,
    "price": 199.99,
    "web_plan": 1,
    "main_plan": 0,
    "billing_plan": {
      "EUR": 199.99,
      "USD": 235.99,
      "RUB": 20000.0
    }
  }
]
}

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

{
"code": -1,
"message": "no sutable traffic plans found for location or id"
}