Получение списка пулов
Получение списка пулов
Данный метод выгружает список пулов из K50 Трекера по заданным параметрам.
Адрес для отправки запроса
https://api.tracker.k50.ru/v2/pool/list/
Поддерживаемые методы: GET, POST
Для POST запросов, параметры в GET не учитываются (кроме параметра apiKey).
Параметры | Описание | Обязательный |
---|---|---|
apiKey | Токен для авторизации. Подробнее | да |
counter | id счетчика, с которого будет сниматься статистика. Список доступных счетчиков можно получить с помощью метода | да |
itemsPerPage | Число результатов в ответе. От 1 до 1000. По-умолчанию 1000 | нет |
page | Порядковый номер страницы ответа. По умолчанию 1 | нет |
Пример запроса
POST
https://api.tracker.k50.ru/v2/pool/list/
{ "apiKey": "00000000-0000-0000-0000-000000000000", "counter": "00000000000", "itemsPerPage": 1000, "page": 1 }
GET
https://api.tracker.k50.ru/v2/pool/list/?apiKey=00000000-0000-0000-0000-000000000000&counter=00000000000&itemsPerPage=1000&page=1
Формат ответа
{ "result":[ {"id":123, "name":"value", "isActive":true, "priority":1, "type":"dynamic", "source":"yandex", "medium":"cpc", "content":"(not set)", "term":"(not set)", "campaign":"(not set)", "label":"(not set)", "reservedSeconds":180, "isClassic":true, "numbersTotal":4, "numbersNeeded":3, "accuracy":0.8, "rotationRules": { "condition":"AND", "rules":[ { "field":"utm_source", "operator":"equal", "value":"YM" } ] }, "numbers":[ [ "79010002233", "79010002233" ], [ "79010002234", "79010002235" ] ] } ], "totalResults":"<TOTAL RESULTS ON ALL PAGES>", "nextLink":"<URL to next page results>" }
Формат ответа в случае ошибочного запроса:
{"error":<HTTP_RESPONSE_CODE>,"message":"<MESSAGE>"}
Пример:
{"error":400,"message":"Invalid filter"}
Параметры ответа
Параметр | Описание |
---|---|
id | Id пула |
name | Название пула |
isActive | Активность пула. true - пул активен, false - остановлен |
priority | Приоритет пула |
type | Тип пула - static (статический)/dynamic (динамический) |
source | Источник по умолчанию |
medium | Тип трафика по умолчанию |
content | Содержание объявления по умолчанию |
term | Ключевое слово по умолчанию |
campaign | Кампания по умолчанию |
label | Label по умолчанию |
reservedSeconds | Время резерва номера для пула |
tags | Список тегов для звонка |
connectDuration | Время ожидания вызова |
isClassic | Тип закрепления номера. true - классическая (закрепление за пользователем, false - закрепление за параметром |
numbersTotal | Количество номеров в пуле |
numbersNeeded | Недостающее количество номеров для точности 95% |
rotationRules | Условия подмены номера |
numbers | "Список номеров. Возвращается в виде двумерного массива. (массив номеров внутри массива блоков номеров). [[""79010002233"", ""79010002233""],[""79010002234"", ""79010002235""]]" |
Получение списка пулов в CSV
Также список пулов можно выгружать в CSV файл.
Необходимо изменить адрес для отправки запроса
Адрес для отправки запроса
https://api.tracker.k50.ru/v2/pool/list/csv
Пример запроса GET
https://api.tracker.k50.ru/v2/pool/list/csv?apiKey=00000000-0000-0000-0000-000000000000&counter=00000000000&itemsPerPage=1000&page=1