# Теги

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

<mark style="color:blue;">`GET`</mark> `https://app.onebot.tech/api/v1/getBotTags`

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

#### Path Parameters

| Name    | Type   | Description |
| ------- | ------ | ----------- |
| bot\_id | String | ID бота     |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан." %}

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

{% endtab %}
{% endtabs %}

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

<mark style="color:blue;">`GET`</mark> `https://app.onebot.tech/api/v1/getContactTags`

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

#### Path Parameters

| Name        | Type   | Description |
| ----------- | ------ | ----------- |
| contact\_id | String | ID контакта |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан" %}

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Так же теги возможно получить со списком контактов, [подробнее](https://help.onebot.tech/onebot-help/rabota-s-api-platformy/kontakty).
{% endhint %}

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

<mark style="color:green;">`POST`</mark> `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` не указан. Если тега с таким именем не существует, то будет создан новый тег с таким именем. |

{% tabs %}
{% tab title="204: No Content Запрос успешно обработан" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

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

<mark style="color:green;">`POST`</mark> `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` не указан. Если тега с таким именем не существует, то будет создан новый тег с таким именем. |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}