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"
}