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

Возвращает действующие тарифы сервера. Код тарифа обязателен при создании устройства: его передают в поле tariff_code команды create_device_req. Сменить тариф устройства можно командой update_device_req. Список общий для всех клиентов сервера.

Запрос и ответ: get_tariffs_req → get_tariffs_resp.
Доступ: токен любого уровня.

Текущая версия ONS

Кода ошибки 2 (Unexpected error) сервер не возвращает.

Запрос

Поля без пометки «обязательно» можно не передавать.

Поле	Тип	Описание
cmd	string	get_tariffs_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ

{
    "cmd": "get_tariffs_req",
    "operation_id": "cdma"
}

Ответ

Поле	Тип	Описание
cmd	string	get_tariffs_resp
operation_id	string	Значение из запроса
status	uint8	1 — успех, 2 — ошибка
tariffs	array	Тарифы: name — название, code — код для tariff_code, description — описание, может быть пустым
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "get_tariffs_resp",
    "operation_id": "cdma",
    "status": 1,
    "tariffs": [
        {
            "name": "Tariff 1",
            "code": "A1",
            "description": ""
        },
        {
            "name": "Tariff 2",
            "code": "A2",
            "description": ""
        }
    ]
}

Ошибки

error_code	error_text	Что случилось
1	Tariffs not found	На сервере нет действующих тарифов, или сервер не смог прочитать их из базы

См. также

• create_device_req — создать устройство с тарифом.
• update_device_req — сменить тариф устройства.