Guruh a'zolarini olish

GET/v1/groups/{identifier}/members1₽–15₽, keyin 1 soat bepul

Har bir sahifada 1 000 tagacha guruh a’zosini qaytaradi. Ayrim yozuvlar javobda bo’lmasligi mumkin, shuning uchun pagination.page_size qaytarilgan elementlarning haqiqiy sonini ko’rsatadi. Keyingi sahifa mavjudligini pagination.has_next_page bildiradi.

Avtorizatsiya

Api-Key sarlavhasi talab qilinadi.

Parametrlar

Nomi	Joyi	Turi	Majburiy	Tavsif
identifier	path	string	ha	Guruhning musbat raqamli IDsi yoki username.
page	query	integer	yo’q	1 dan boshlanadigan sahifa raqami. Standart qiymat 1.

Misol

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()

Javob — 200 OK

{
  "data": [
    {
      "data": { "id": 12345, "name": "Ivan Ivanov", "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
  }
}

Billing

Eksportga kirish narxi uning hajmiga bog’liq:

Mavjud a’zolar	Narx
1–10	1₽
11–49	5₽
50+	15₽

Birinchi muvaffaqiyatli pullik so’rov shu API hisobiga ayni guruhning barcha sahifalarini bir soatga ochadi. ID yoki username bilan takroriy so’rovlar Telesint-Billing-Charged: 0 qaytaradi va muddatni uzaytirmaydi.

Muvaffaqiyatli javobda Telesint-Billing-Charged, Telesint-Billing-Balance va Cache-Control: private, no-store bo’ladi.

Xatoliklar

• 400 — identifier noto’g’ri yoki balans yetarli emas.
• 404 — guruh yoki sahifa topilmadi, yoxud qaytariladigan yozuv yo’q.
• 422 — page noto’g’ri.
• 503 — xizmat vaqtincha ishlamayapti.