Добавление тегов для лидов
Данный метод назначает теги для выбранных лидов
Адрес для отправки запроса
https://api.tracker.k50.ru/v2/leads/addTags/
Поддерживаемые методы: GET, POST
Для POST запросов, параметры в GET не учитываются (кроме параметра apiKey).
Параметр | Значение | Обязательный |
---|---|---|
apiKey | Токен для авторизации. Подробнее | Да |
counter | id счетчика, с которого будем снимать статистику. Список доступных счетчиков можно получить с помощью метода | Да |
leadIds | id заказов, для которых необходимо назначить теги. Задаётся в виде массива | Да |
tags | Список тегов, которые будут назначены лидам. Задаётся в виде массива | Да |
Пример запроса
POST
https://api.tracker.k50.ru/v2/leads/addTags/
{ "apiKey": "00000000-0000-0000-0000-000000000000", "counter": "00000000000", "leadIds": ["leadId1","leadId2"], "tags": ["newTag","newTag2"] }
GET
http://api.tracker.k50.ru/v2/leads/addTags/?apiKey=00000000-0000-0000-0000-000000000000&counter=00000000000&leadIds[]=leadId1&leadIds[]=leadId2&tags[]=newTag&tags[]=newTag2
Формат ответа
Формат ответа в случае корректного запроса
{"result":{"leadId1":{"result":"ok"},"leadId2":{"result":"ok"}}}
Обратите внимание
Если для выбранного лида уже назначены теги из запроса, метод будет считать это успешным назначением тега (то есть вернёт {“result”:”ok”}).
Возможны ситуации, когда запрос построен верно, но при назначении тега на лид возникли ошибки (например, выбранный id лида отсутствует в счетчике). В этом случае ответ будет возвращаться в следующем формате.
{"result":{"leadId1":{"result":"ok"},"leadId2":{"result":"error","msg":"leadId Not Found"}}}
Формат ответа в случае ошибочного запроса:
Пример:
{"error":403,"message":"No counter found"}