X-Git-Url: https://git.stg.codes/stg.git/blobdiff_plain/335f5e8f4be04e68fa76f64c722613efc6fb98fa..06c1548a92767365aa31a7af539475d535a33da3:/doc/xmlrpc-doc/API-tariffs.xml diff --git a/doc/xmlrpc-doc/API-tariffs.xml b/doc/xmlrpc-doc/API-tariffs.xml new file mode 100644 index 00000000..fadc20b3 --- /dev/null +++ b/doc/xmlrpc-doc/API-tariffs.xml @@ -0,0 +1,639 @@ + + + Управление тарифами + В этом разделе собраны вызовы для манипулирования тарифными планами. Тарифный план включает в себя: + + название; + абонплата; + количество бесплатных мегабайт, включенных в абонплату; + стоимость "заморозки" пользователя; + + тип подсчета трафика: + + только входящий, + только исходящий, + входящий и исходящий суммарно, + максимум из входящего и исходящего + + + + информацию о тарификации направлений: + + время начала дня; + конца дня; + цена за мегабайт трафика до порога днем; + цена за мегабайт трафика после порога днем; + цена за мегабайт трафика до порога ночью; + цена за мегабайт трафика после порога ночью; + пороговый объем трафика в мегабайтах; + флаг игнорирования времени суток; + флаг игнорирования порога. + + + + + + stargazer.get_tariff + + + stargazer.get_tariff + Получает информацию о тарифном плане + + + + + stargazer.get_tariff + string cookie + string tariff + + + + + Description + Метод stargazer.get_tariff получает информацию о тарифном плане. + + + string cookie + + Авторизационный cookie. Для авторизации в системе используется метод stargazer.login + + + + string tariff + + Название тарифа + + + + + Return Value + + Возвращает структуру: + + + boolean result + + Результат операции. true - успешно, false - неудача (неправильный или устаревший cookie, неправильное название тарифа). + + + + string tariff + + Название тарифа + + + + double fee + + Абонплата + + + + double freemb + + Количество бесплатных мегабайт включенных в абонплату + + + + double passivecost + + Стоимость "заморозки" пользователя + + + + int trafftype + + Тип подсчета трафика: + + 0 — подсчитывать только исходящий трафик + 1 — подсчитывать только входящий трафик + 2 — подсчитывать суммарно входящий и исходящий трафик + 3 — подсчитывать максимальный из входящего и исходящего трафика + + + + + + array of struct dirprices + + Массив стурктур, описывающих тарификацию направлений: + + + int hday + + Часы начала дня + + + + int mday + + Минуты начала дня + + + + int hnight + + Часы начала ночи + + + + int mnight + + Минуты начала ночи + + + + double pricedaya + + Цена 1 мегабайта трафика днем до превышения порогового значения + + + + double pricedayb + + Цена 1 мегабайта трафика днем после превышения порогового значения + + + + double pricenighta + + Цена 1 мегабайта трафика ночью до превышения порогового значения + + + + double pricenightb + + Цена 1 мегабайта трафика ночью после превышения порогового значения + + + + int threshold + + Величина порога в мегабайтах + + + + boolean singleprice + + Цена не зависит от времени суток + + + + boolean nodiscount + + Цена не зависит от порога + + + + + + + + + + + + See also + + stargazer.get_tariffs, + stargazer.add_tariff, + stargazer.del_tariff, + stargazer.chg_tariff + + + + + + stargazer.get_tariffs + + + stargazer.get_tariffs + Получает информацию о тарифных планах + + + + + stargazer.get_tariffs + string cookie + + + + + Description + Метод stargazer.get_tariffs получает информацию о тарифных планах. + + + string cookie + + Авторизационный cookie. Для авторизации в системе используется метод stargazer.login + + + + + Return Value + + Возвращает массив структур: + + + boolean result + + Результат операции. true - успешно, false - неудача (неправильный или устаревший cookie, неправильное название тарифа). + + + + string tariff + + Название тарифа + + + + double fee + + Абонплата + + + + double freemb + + Количество бесплатных мегабайт включенных в абонплату + + + + double passivecost + + Стоимость "заморозки" пользователя + + + + int trafftype + + Тип подсчета трафика: + + 0 — подсчитывать только исходящий трафик + 1 — подсчитывать только входящий трафик + 2 — подсчитывать суммарно входящий и исходящий трафик + 3 — подсчитывать максимальный из входящего и исходящего трафика + + + + + + array of struct dirprices + + Массив стурктур, описывающих тарификацию направлений: + + + int hday + + Часы начала дня + + + + int mday + + Минуты начала дня + + + + int hnight + + Часы начала ночи + + + + int mnight + + Минуты начала ночи + + + + double pricedaya + + Цена 1 мегабайта трафика днем до превышения порогового значения + + + + double pricedayb + + Цена 1 мегабайта трафика днем после превышения порогового значения + + + + double pricenighta + + Цена 1 мегабайта трафика ночью до превышения порогового значения + + + + double pricenightb + + Цена 1 мегабайта трафика ночью после превышения порогового значения + + + + int threshold + + Величина порога в мегабайтах + + + + boolean singleprice + + Цена не зависит от времени стуок + + + + boolean nodiscount + + Цена не зависит от порога + + + + + + + + + + + + See also + + stargazer.get_tariff, + stargazer.add_tariff, + stargazer.del_tariff, + stargazer.chg_tariff + + + + + + stargazer.add_tariff + + + stargazer.add_tariff + Добавляет в систему новый тарифный план + + + + + stargazer.add_tariff + string cookie + string tariff + + + + + Description + Метод stargazer.add_tariff добавляет в систему новый "пустой" тарифный план. Для его настройки используется метод stargazer.chg_tariff. + + + string cookie + + Авторизационный cookie. Для авторизации в системе используется метод stargazer.login + + + + string tariff + + Название тарифа + + + + + Return Value + Возвращет true в случае успеха и false в случае неудачи + + + + See also + + stargazer.get_tariffs, + stargazer.get_tariff, + stargazer.del_tariff, + stargazer.chg_tariff + + + + + + stargazer.del_tariff + + + stargazer.del_tariff + Удаляет из системы тарифный план + + + + + stargazer.del_tariff + string cookie + string tariff + + + + + Description + Метод stargazer.del_tariff удаляет из системы тарифный план + + + string cookie + + Авторизационный cookie. Для авторизации в системе используется метод stargazer.login + + + + string tariff + + Название тарифа + + + + + Return Value + Возвращет true в случае успеха и false в случае неудачи + + + + See also + + stargazer.get_tariffs, + stargazer.get_tariff, + stargazer.add_tariff, + stargazer.chg_tariff + + + + + + stargazer.chg_tariff + + + stargazer.chg_tariff + Изменяет информацию о тарифном плане + + + + + stargazer.chg_tariff + string cookie + string tariff + struct info + + + + + Description + Метод stargazer.chg_tariff изменяет информацию о тарифном плане. Допустимо частичное указание параметров в структуре info. В этом случае изменение затронет только указанные параметры. Дополнительные поля структуры (не входящие в описание) будут проигнорированы. + + + string cookie + + Авторизационный cookie. Для авторизации в системе используется метод stargazer.login + + + + string tariff + + Название тарифа + + + + struct info + + + Структура с информацией о тарифном плане: + + + string tariff + + Название тарифа + + + + double fee + + Абонплата + + + + double freemb + + Количество свободных мегабайт, включенных в абонплату + + + + double passivecost + + Стоимость заморозки пользователя + + + + int trafftype + + Тип подсчета трафика: + + 0 — подсчитывать только исходящий трафик + 1 — подсчитывать только входящий трафик + 2 — подсчитывать суммарно входящий и исходящий трафик + 3 — подсчитывать максимальный из входящего и исходящего трафика + + + + + + array of struct dirprices + + Массив стурктур, описывающих тарификацию направлений: + + + int hday + + Часы начала дня + + + + int mday + + Минуты начала дня + + + + int hnight + + Часы начала ночи + + + + int mnight + + Минуты начала ночи + + + + double pricedaya + + Цена 1 мегабайта трафика днем до превышения порогового значения + + + + double pricedayb + + Цена 1 мегабайта трафика днем после превышения порогового значения + + + + double pricenighta + + Цена 1 мегабайта трафика ночью до превышения порогового значения + + + + double pricenightb + + Цена 1 мегабайта трафика ночью после превышения порогового значения + + + + int threshold + + Величина порога в мегабайтах + + + + boolean singleprice + + Цена не зависит от времени стуок + + + + boolean nodiscount + + Цена не зависит от порога + + + + + + + + + + + + + Return Value + Возвращет true в случае успеха и false в случае неудачи + + + + See also + + stargazer.get_tariffs, + stargazer.get_tariff, + stargazer.add_tariff, + stargazer.del_tariff + + + +