Отримати учасників групи

GET/v1/groups/{identifier}/members1₽–15₽, потім безкоштовно 1 годину

Повертає до 1 000 учасників на сторінці. Деякі записи можуть бути відсутні у відповіді, тому pagination.page_size показує фактичну кількість повернутих елементів. Наявність наступної сторінки вказує pagination.has_next_page.

Авторизація

Потрібен заголовок Api-Key.

Параметри

Ім’я	Де	Тип	Обов’язковий	Опис
identifier	path	string	так	Додатний числовий ID групи або username.
page	query	integer	ні	Номер сторінки, починаючи з 1. Типово 1.

Приклад

cURL

curl -i -H "Api-Key: $API_KEY" \
  "https://api.telesint.dev/v1/groups/example_group/members?page=1"

Python

import os, requests

response = requests.get(
    "https://api.telesint.dev/v1/groups/example_group/members",
    params={"page": 1},
    headers={"Api-Key": os.environ["API_KEY"]},
    timeout=30,
)
response.raise_for_status()
result = response.json()

Відповідь — 200 OK

{
  "data": [
    {
      "data": { "id": 12345, "name": "Іван Іванов", "username": "ivan" },
      "update": "2026-07-20T12:34:56Z",
      "create": "2024-03-10T09:00:00Z",
      "admin": {
        "id": 12345,
        "role": "admin",
        "is_creator": true,
        "update": "2026-07-18T08:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "has_next_page": true
  }
}

Білінг

Вартість доступу до вивантаження залежить від його обсягу:

Доступно учасників	Ціна
1–10	1₽
11–49	5₽
50+	15₽

Перший успішний платний запит відкриває цьому API-акаунту всі сторінки тієї самої групи на одну годину. Повторні запити за ID або username повертають Telesint-Billing-Charged: 0 і не продовжують цей інтервал.

Успішна відповідь містить Telesint-Billing-Charged, Telesint-Billing-Balance і Cache-Control: private, no-store.

Помилки

• 400 — некоректний identifier або недостатній баланс.
• 404 — групу чи сторінку не знайдено, або немає доступних записів.
• 422 — некоректний page.
• 503 — сервіс тимчасово недоступний.