# GET /v1/telegram/links

Список привязок Telegram

Активные и заблокированные привязки Telegram этого паблишера. Идентификаторы чатов приватны. Возвращает enabled:false, если Telegram недоступен. Требуется область `publisher:read` (ключ API или веб-сессия). Уровень лимита: `read`.

- Требуемая область: `publisher:read`
- Лимит запросов: `read` — 120 запросов за окно в 60 с на ключ API или веб-сессию

## Параметры

Нет параметров.

## Ответ

```
{ bot_username: string | null; enabled: boolean; links: { created_at: string; id: integer; locale: "en" | "vi" | "es" | "pt" | "fr" | "id" | "ru" | "zh" | "ar"; status: "active" | "blocked"; tg_username: string | null }[]; max_links: 3 }
```

## Ошибки

Маршруты с ограничением частоты возвращают `RateLimit-Limit`, `RateLimit-Remaining` и `RateLimit-Reset` (секунд до конца окна); ответ 429 также содержит `Retry-After`. Заголовки могут отсутствовать, пока ограничитель временно недоступен (запросы тогда пропускаются).

| Статус | Смысл |
|---|---|
| 401 | Ключ API отсутствует, недействителен или отозван. |
| 403 | У ключа нет требуемой области, либо операция недоступна для этого субъекта. |
| 429 | Лимит запросов превышен; подождите `Retry-After` секунд. |

HTML-документация: https://agimone.com/ru/developers/api/#list-telegram-links
API 2026-10
