Для запроса на присвоение тега существующему получателю используется метод api/subscribers/tags/set
.
Чтобы присвоить тег получателю, требуется его уникальный идентификатор, указанный в параметре
EXT_USER_ID
при создании. Подробнее в статье. Вызов метода api/subscribers/tags/set
Чтоб вызвать метод api/subscribers/tags/set
, отправьте POST-запрос на URL-адрес https://app.edna.ru/api/subscribers/tags/set
.
Если запрос выполнен успешно, метод возвращает ответ с кодом 200
.
Формат тела запроса
{ "tag": { "name": "best_user" }, "subscriber": [ { "address": "test12345", "type": "EXT_USER_ID" } ] }
Параметры запроса
Параметр | Тип | Описание |
tag | object | Объект тега. |
tag.name | string | Название тега получателя. |
subscriber | array of strings | Массив идентификаторов получателя. |
subscriber.address | string | Уникальный идентификатор получателя, указанный в качестве значения параметра EXT_USER_ID при создании получателя. Подробнее в статье. |
subscriber.type | string | Тип идентификатора. Значение — . |
Пример ответа
[ { "id": 66402870, "blacklisted": false, "addresses": [ { "id": "09c2dc23-715e-4cde-8034-8ddfac6d91b5", "address": "test12345" } ], "parameterValues": [], "tagValues": [ { "name": "best_user" } ] } ]