Запросы осуществляются в формате JSON путем отправления POST запроса на адрес http://a.clickfrog.ru/api/
JSON состоит из 3х обязательных параметров: id, md5, task а также специфичных параметров для каждого метода.
В первых двух параметрах передаются данные для авторизации. В параметре task - вызываемый метод.
Ответ состоит из JSON объекта.
В случае успешного запроса в объекте присутсвует свойство 'ok', а сам ответ находится в его значении.
В случае ошибки при запросе в объекте присутсвует свойство 'error', описание ошибки находится в его значении.
Исключением является метод add_sites, который возращает массив объектов аналогичной структуры.
API подключается по запросу в поддержку.
Авторизация проводится путем передачи id пользователя(сообщается при подключении API) и md5 от пароля в json параметрах id и md5.
Запрещено делать более 60 запросов в минуту.
В случае если отправлено более 60 запросов - пользователь блокируется на минуту.
В случае если лимиты нарушались более 60 раз в сутки - API отключается и подключается только по запросу в поддержку.
Использование метода get_stat с параметром stype=1,stype=2 и stype=7 учитывается как 10 запросов.
Использование метода get_stat с параметром stype=3 возможно не чаще раза в сутки для одного сайта.
get_audit_balance
Получает баланс Аудит Трафика.
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_audit_balance"}'Пример ответа:
{ "ok": "8000.00" }
get_sites_audit_status
Получить состояние Аудита Трафика по сайту.
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_sites_audit_status"}'Пример ответа:
{ "ok": { "1": { "id": "1", "domain": "example.com", "state": "OFF" }, "2": { "id": "2", "domain": "example.org", "state": "ON" } } }Описание ответа:
get_site_audit_status
Получить состояние Аудита Трафика по сайту.
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_site_audit_status", "site_id":1}'Пример ответа:
{ "ok": "NO CODE", "info": [{ "url": "http:\/\/example.com\/page1", "js_code": 1, "php_code": 0 }, { "url": "http:\/\/example.org\/page2", "js_code": -1, "php_code": 1 }] }Описание ответа:
get_ban_limits
Получить параметры блокировки
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_ban_limits"}'Пример ответа:
{ "ok": { "uid_ban_limit": "-8", "pads_visits_limit": "10", "pad_ban_limit": "-3.30" } }Описание ответа:
set_ban_limits
Установить параметры блокировки
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"set_ban_limits", "uid_ban_limit": "-8","pads_visits_limit": "10","pad_ban_limit": "-3.30"}'Пример ответа:
Аналогично методу get_ban_limits
start_stop_audit
Запустить или остановить Аудит Трафика
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"start_stop_audit", "site_id": "2","state": "ON"}'Пример ответа:
{ "ok": "ON" }
add_sites
Добавить сайт в Аудит Трафика
Дополнительные параметры:
curl -d '{"id":1,"md5":"e10adc3949ba44ff883e","task":"add_sites", "urls":["example.org","exaple.com"]}'Пример ответа:
{ [{ "ok": 100 }, { "error": "WRONG URL" }] }Описание ответа:
check_code
Проверить наличие кода на странице
Дополнительные параметры:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"check_code", "url":"example.org/12?d=e"}Пример ответа:
{ "ok": { "php": 1, "js": 0 } }Описание ответа:
get_stat
Получить статистику по сайту
Дополнительные параметры:
curl -d '{"id":1,"md5":"e10adc3949ba44ff883e","task":"get_stat","site_id":1,"stype":1, "from":1385501505,"to":1385541505}'Пример ответа (stype=1):
{ "ok": [ ["1385537718", "93.127.125.94", "example.org\/?_openstat=YmVndW47MzAyMDAwNDUyOzMwMjAwMDQ1ODs", "begun machinelife.ru", "4"], ["1385530612", "209.85.238.9", "example.org\/?utm_source=trafmag&utm_medium=click&tracking=1043", "trafmag (\u043f\u0443\u0441\u0442 \u0440\u0435\u0444\u0435\u0440) 1043", "1"], ["1385505224", "66.249.93.44", "example.org\/?utmka=lalala&keyword&site=example.org", "batterfliay.ru", "16"], ["1385504840", "192.168.1.153", "example.org\/?utm_source=trafmag&utm_campaign=trafmag&tracking=944", "trafmag (\u043f\u0443\u0441\u0442 \u0440\u0435\u0444\u0435\u0440) 944", "4"], ["1385503928", "46.30.167.204", "example.org\/?utm_source=trafmag&utm_medium=click&utm_campaign=trafmag", "trafmag (\u043f\u0443\u0441\u0442 \u0440\u0435\u0444\u0435\u0440) 185", "3"], ["1385503418", "66.249.81.44", "example.org\/?utmka=lalala&keyword&site=5864f0a8cffd909f.anonymous.google", "5864f0a8cffd909f.anonymous.google", "1"] ] }Описание ответа (stype=1):
{ "ok": [ ["2013-11-27", "adwords mail.google.com", "example.com\/?utmka=lalala&keyword=&site=mail.google.com", "1"], ["2013-11-27", "begun rating.openstat.ru", "example.com\/?_openstat=YmVndW47MzAyMDAwNDUyOzMwMjAwMTE2MD", "1"], ["2013-11-27", "google.com example.org", "example.com\/?utmka=lalala&keyword=&site=example.org", "25"], ["2013-11-26", "google.com example.org", "example.com\/?utmka=lalala&keyword=&site=example.org", "25"] ] }Описание ответа (stype=2):
{ "ok": [ ["1369297040", "armyansk.info", "0", "77.52.191.86", "B5368", "example.org\/?_openstat=YmVndW47MzE0NTQ4NTQ4OzMxNDU0ODU3MDs", "0,03", "armyansk.info\/transport\/train-schedule"], ["1369297510", "ru.podii.com.ua", "0", "195.24.157.158", "B5372", "example.org\/?_openstat=YmVndW47MzE0NTQ4NTQ4OzMxNDU0ODU3MDs", "0,03", "ru.podii.com.ua\/business\/2013\/05\/23\/103707.html"], ["1369299042", "smotri.com", "-2.69444", "193.108.171.116", "A2008879", "example.org\/?_openstat=YmVndW47MzE0NTQ4NTQ4OzMxNDU0ODU3MDs", "0,03", "smotri.com\/live\/00kleopatra00"], ] }Описание ответа (stype=3):
get_marks_list
Получить список меток из трекинга потоков
Пример запроса:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_marks_list"}'
{"ok": [ { "id":"7", "lines":"5", "reserved_fragment":"test_replace", "reserver_is_referer":"0", "domain":null, "state":"6", "balance":"0", "redirect_type":"2", "redirect_number":"0", "info_mail":"mail@clickfrog.ru" } ] }
get_marks_stat
Получить статистику по id-метки
Пример запроса:
curl -d '{"id":1,"md5":"2e676f870f840d33448fa6718cc89db2","task":"get_marks_stat", "tid":"1","from":"2015-11-01","to":"2015-11-06"}'
{"ok": [ { "id":"test1", "clicks":"4", "calls0":"0", "calls1":"0", "calls2":"0", "autoresponds":"0" } ] }
set_direct_ips
Добавить ip адреса в ручной бан модуля "Аудит Директ + бан"
Дополнительные параметры:
curl -d '{"id":42,"md5":"e10adc3949ba44ff883e","task":"set_direct_ips", "site_id":1, "yad_id":"1", "ips":"222.22.22.22,222.22.22.23"}' http://a.clickfrog.ru/api/Пример ответа:
{ [{ "ok": SAVED }, { "error": "WRONG URL" }] }