Перейти к основному содержимому

Получить информацию о связях профиля

Описание

Запрос отдаёт информацию о связях профиля из базы данных А, свойствах связей и значениях свойств.

URL-адрес

Метод: POST.

https://example.com/api/v1.1/relations/get_counter

Параметры запроса

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
rel_idint3ДаID связи
<profile>
"profile_id": "c1wefohoi1312"
ДаПрофиль из базы данных А для поиска
Поиск профиля подписчика
emailstring"john@example.com""matching":"email" - по профилю и подпискам

"matching":"email_profile" - только по профилю
Email-адрес
phonestring"+79000000000""matching":"phone"Номер телефона
profile_idstring"abcdefghijklmnqrstuvwxyz""matching":"profile_id"Идентификатор профиля
field_namestring"CRM_ID""matching":"custom"Название кастомного поля профиля для поиска.
field_valueint/string"12345""matching":"custom"

Значение кастомного поля для поиска.

подсказка

Доступен поиск по сочетанию значений поля с типом "теги". Теги передаются в строке черз запятую: "тег_1, тег_2".

resource_idint24НетИдентификатор ресурса для поиска по email и phone

Пример запроса


{
"token": "8d08f4ea57c74916909e9d324c20a6bc",
"rel_id":3,
"profile_id":"5d63dbdb439e7306b596c5d0"
}

Пример ответа


{
"data": {
"profile_id": "5c910f6bc484d023b1309bee",
"profile_xxh": "54ec2d76ac22a964",
"total": 1,
"props": {
"Donate": {
"total": 1,
"top": [
{
"profile_id": "5c910938c484d023b1309bab",
"value": 20
}
],
"sum": null
},
"Like": {
"total": 1,
"top": null,
"sum": 2
},
"Subscriber": {
"total": 1,
"top": null,
"sum": null
}
}
},
"error": 0,
"error_text": "Successful operation"
}

Возвращаемые параметры

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
dataobjectИнформация о связях профиля
data.profile_idstringИдентификатор профиля
data.profile_xxhstringХешированый идентификатор профиля
data.totalintКоличество связей c с другими профилями
data.propsobjectСвойства связей

Свойства связей: числовые

ПараметрТипОписание
totalintКоличество полученных свойств
topobjectТоп свойства (связанные профили и значения)
sumint/floatСумма числового свойства

Свойства связей: булевые

ПараметрТипОписание
totalintКоличество полученных свойств
topnullне актуально
sumnullне актуально