Теги

Получить список тегов бота

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

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

Path Parameters

Name	Type	Description
bot_id	String	ID бота

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

"data": [
    {
      "id": 3,
      "name": "Одежда"
    },
    {
      "id": 2,
      "name": "Акция"
    },
    {
      "id": 1,
      "name": "Горячий"
    }
}

Получить список тегов контакта

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

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

Path Parameters

Name	Type	Description
contact_id	String	ID контакта

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

{
  "data": [
    {
      "id": 1,
      "name": "Горячий"
    },
    {
      "id": 2,
      "name": "Ботинки"
    }
  ]
}

Так же теги возможно получить со списком контактов, подробнее.

Добавить тег к контакту

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

Этот метод позволяет привязать тег к контакту по ID/ имени тега.

Request Body

Name	Type	Description
contact_id	Integer	ID контакта
tag_id	Integer	ID тега, если namе не указан.
name	String	Имя тега, если tag_id не указан. Если тега с таким именем не существует, то будет создан новый тег с таким именем.

204: No Content Запрос успешно обработан

{
    // Response
}

Удалить тег у контакта

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

Этот метод позволяет отвязать тег от контакта по ID/ имени тега.

Request Body

Name	Type	Description
contact_id	String	ID контакта
tag_id	String	ID тега, если namе не указан.
nam	String	Имя тега, если tag_id не указан. Если тега с таким именем не существует, то будет создан новый тег с таким именем.

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

{
    // Response
}