# GET /v1/telegram/links

Daftar tautan Telegram

Tautan Telegram aktif dan terblokir untuk publisher ini. Pengenal obrolan bersifat privat. Mengembalikan enabled:false jika Telegram tidak tersedia. Memerlukan scope `publisher:read` (kunci API atau sesi web). Tingkat batas laju: `read`.

- Scope wajib: `publisher:read`
- Batas laju: `read` — 120 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

Tanpa parameter.

## Respons

```
{ 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 }
```

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |

Dokumentasi HTML: https://agimone.com/id/developers/api/#list-telegram-links
API 2026-10
