Загальний опис
Історія змін
Рекомендації до оновлення
Плани на майбутнє
Відомі проблеми
Онлайн демо
Допомога проекту
Люди
Трохи про безпеку
FAQ
Це стара версія документу!
У Ubilling починаючи з релізу 0.3.1 підтримується виклик зовнішніми програмами певних внутрішніх процедур білінгу. Для цього потрібна опція REMOTEAPI_ENABLED=1 alter.ini. Для авторизації використається серійний номер Ubilling.
Формат викликів за допомогою HTTP GET запитів:
http://billing.isp/?module=remoteapi&key=[ubserial]&action=[action][¶m=[parameter]]
На даний момент підтримуються наступні action:
array(TarrifName => array('price' => TariffCost, 'daysperiod' => TariffChargePeriod), Vservice1 => array('price' => Vservice1Cost, 'daysperiod' => Vservice1ChargePeriod), Vservice2 => array('price' => Vservice2Cost, 'daysperiod' => Vservice2ChargePeriod), VserviceN => array('price' => VserviceNCost, 'daysperiod' => VserviceChargePeriod) ) //Примечание: "TarrifName => TariffCost" - всегда первый элемент массива
При неверных вызовах Remote API будет возвращать следующие исключения:
На данный момент вызовы reset и handlersrebuild используються для работы UHW. Пока что мы не хотим выносить слишком много излишнего функционала в это API в целях безопасности. Если вы хотите вызывать что-то из того что делает Ubilling в своих внешних приложениях - мы с удовольствием рассмотрим все предложения.
Если требуется вызов каких-то процедур из API (а оно для этого и есть), можно оформить это в таком виде:
/usr/local/bin/curl -o /dev/null "http://127.0.0.1/billing/?module=remoteapi&key=ваш_серийник&action=vserviceschargefee"
или так
/usr/local/bin/curl -o /dev/null "http://127.0.0.1/billing/?module=remoteapi&key=ваш_серийник&action=swping"
Мысль надеюсь понятна.
Для удобства и красивости, можно воспользоваться вот таким скриптом /bin/ubapi (не забываем chmod a+x /bin/ubapi) :
#!/bin/sh #= Change this to your real Ubilling serial == UBSERIAL=UB000000000000000000000000000000000 #============================================== if [ $# -ne 1 ] then echo "Usage: /bin/ubapi \"action\"" echo "Example: /bin/ubapi \"backupdb\" or /bin/ubapi \"swping\"" exit fi ACTION=$1 /usr/local/bin/curl -o /dev/null "http://127.0.0.1/billing/?module=remoteapi&key=${UBSERIAL}&action=${ACTION}"
Начиная с релиза 0.8.0 он уже лежит по нужному пути. Вам стоит только установить в нем серийник вашего Ubilling.
И как теперь будет выглядеть crontab -e в минимальном джентльменском наборе? А вот как-то так:
40 1 1 * * /bin/ubapi "vserviceschargefee" */20 * * * * /bin/ubapi "swping" */10 * * * * /bin/ubapi "fastping" 5 * * * * /bin/ubapi "fullhostscan¶m=traffdiff&nn=1" 0 */1 * * * /bin/ubapi "swpoll" */10 * * * * /bin/ubapi "watchdog" */5 * * * * /bin/ubapi "senddog" 1 1 * * * /bin/ubapi "backupdb" 3 * * * * /bin/ubapi "rebuildglscache" 10 2 * * * /bin/ubapi "dealwithit" 50 23 * * * /bin/ubapi "exhorse" */10 * * * * /bin/ubapi "nasmon" */30 * * * * /bin/ubapi "mtsigmonpoll" 10 10 1 * * /bin/ubapi "autocleandb" 10 */1 * * * /bin/ubapi "fdbarchive" */10 * * * * /bin/ubapi "oltpoll" */20 * * * * /bin/ubapi "cachedog" */2 * * * * /bin/ubapi "multigen" 10 0 * * * /bin/ubapi "feesharvester"
Это необходимый минимум(!) для обеспечения минимально рабочего состояния Ubilling.
