Реферальная система

С помощью представленных методов ты можешь получить информацию о рефералах, реферерах твоих контактов.

Реферер – пользователь стоящий выше, тот кто пригласил в реферальную программу.

Реферал – пользователь стоящий ниже, тот кого пригласили в реферальную программу.

Получить рефереры контакта

GET https://app.onebot.tech/api/v1/getReferrers

Этот метод позволяет получить список или дерево рефереров контакта.

Path Parameters

Name	Type	Description
contact_id	Integer	ID контакта
depth	Integer	Глубина дерева (мин. 1, макс. 10)
is_flat	Boolean	По умолчанию ns получаешь информацию в виде дерева, если укажешь значение этого поля в 1, то информация придет в виде списка рефереров.

200: OK Запрос успешно обработан. Результат в виде дерева, включая текущий контакт.

{
  "data": {
    "id": 3,
    "name": "Иван Иванов",
    "messenger": "telegram",
    "created_at": "2022-11-10T10:38:28+00:00",
    "referrer": {
      "id": 2,
      "name": "Петр Петров",
      "messenger": "telegram",
      "created_at": "2022-11-10T10:38:25+00:00",
      "referrer": {
        "id": 1,
        "name": "Василий Васильев",
        "messenger": "telegram",
        "created_at": "2022-11-11T10:11:42+00:00"
      }
    }
  }
}

Получить рефералы контакта

POST https://app.onebot.tech/api/v1/getReferrals

Этот метод позволяет получить список рефералов контакта

Path Parameters

Name	Type	Description
filters	Object	Поля для фильтрации данных. Например фильтр по тегу: {"tag_name": "Горячий"} {"tag_name": ["Горячий", "Холодный"]} {"tag_id": 1} {"tag_id": [1, 2]}
page	Integer	Номер страницы результатов.
contact_id	Integer	ID контакта.

200: OK Запрос успешно обработан

{
    // Response
}

Получить количество рефералов всей сети контакта

POST https://app.onebot.tech/api/v1/getCountReferrals

Этот метод позволяет получить количество рефералов всей сети контакта

Path Parameters

Name	Type	Description
filters	Object	Поля для фильтрации данных. Например фильтр по тегу: {"tag_name": "Горячий"} {"tag_name": ["Горячий", "Холодный"]} {"tag_id": 1} {"tag_id": [1, 2]}
	Integer	ID контакта

200: OK Запрос успешно обработан

{
    // Response
}