API: Теги

Эндпоинты для работы с тегами. Теги позволяют группировать ссылки и пиксели для удобной фильтрации и аналитики.

Список тегов

GET /api/tags

Ответ:

[
  {
    "id": 1,
    "name": "Промо",
    "color": "#6366f1",
    "linksCount": 5
  }
]

Сводка по тегам

GET /api/tags/summary?period=7d

Query параметры: period — 1d | 7d | 30d | 90d | 1y

Ответ:

[
  {
    "id": 1,
    "name": "Промо",
    "color": "#6366f1",
    "linksCount": 5,
    "totalClicks": 320,
    "uniqueClicks": 280
  }
]

Создать тег

POST /api/tags

Body:

{
  "name": "Промо",
  "color": "#6366f1"
}

color — опциональный, hex-формат #RRGGBB.

Ответ:

{
  "id": 1,
  "name": "Промо",
  "color": "#6366f1",
  "user_id": 1,
  "created_at": "2025-01-15T10:00:00Z"
}

Обновить тег

PUT /api/tags/:id

Body:

{
  "name": "Реклама",
  "color": "#ef4444"
}

Оба поля опциональны.

Ответ: обновлённый объект тега.

Удалить тег

DELETE /api/tags/:id

Ответ:

{ "ok": true }

Отправить PNG статистики тега

POST /api/tags/:id/send-image

Body:

{
  "period": "7d"
}

Генерирует и отправляет PNG-изображение со статистикой тега в бот-чат.

Ответ:

{ "ok": true }

Привязать теги к ссылке

POST /api/tags/links/:linkId

Body:

{
  "tagIds": [1, 2]
}

Ответ:

{ "ok": true }

Отвязать теги от ссылки

DELETE /api/tags/links/:linkId

Body:

{
  "tagIds": [1]
}

Ответ:

{ "ok": true }

Для всех эндпоинтов используйте заголовок Authorization: Bearer <token>.