ID bo'yicha guruhni olish

GET/v1/groups/{identifier}2₽ per 2xx

Guruh haqida ma’lumot qaytaradi: sarlavha, tavsif, a’zolar soni, tillar, administratorlar, @username tarixi.

Avtorizatsiya

Api-Key sarlavhasi kerak.

Yo’l parametrlari

Nom	Tur	Majburiy	Tavsif
identifier	string	ha	Guruhning raqamli ID si yoki @username (masalan example_group).

Misollar

cURL

# Raqamli ID bo'yicha
curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/groups/12345

# @username bo'yicha
curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/groups/example_group

Python

import os, requests

def get_group(identifier: str | int) -> dict:
    response = requests.get(
        f"https://api.telesint.dev/v1/groups/{identifier}",
        headers={"Api-Key": os.environ["API_KEY"]},
        timeout=10,
    )
    response.raise_for_status()
    return response.json()["data"]

group = get_group("example_group")

JavaScript

async function getGroup(identifier) {
  const res = await fetch(
    `https://api.telesint.dev/v1/groups/${identifier}`,
    { headers: { 'Api-Key': process.env.API_KEY } },
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = await res.json();
  return data;
}

const group = await getGroup('example_group');

Javob — 200 OK

{
  "data": {
    "id": 12345,
    "url": "example_group",
    "h_url": [
      { "value": "example_group_old", "update": "2021-01-01T00:00:00" },
      { "value": "example_group_very_old", "update": "2020-06-01T00:00:00" }
    ],
    "title": "Example Group",
    "about": "Example Group About",
    "langs": [
      { "lang_code": "ru", "name": "Russian" }
    ],
    "is_open": true,
    "users": 100,
    "admins": [
      { "id": 12345, "is_creator": true, "role": "admin", "update": "2021-01-01T00:00:00" }
    ],
    "update": "2021-01-01T00:00:00",
    "create": "2021-01-01T00:00:00",
    "shadow": false
  }
}

Maydonlar — data

Maydon	Tur	Tavsif
id	integer	O’zgarmas guruh ID si.
url	string | null	Joriy @username.
h_url	massiv history entry	Oldingi @usernamelar.
title	string	Guruh sarlavhasi.
about	string | null	Guruh tavsifi.
langs	massiv { lang_code, name }	Guruh tillari.
is_open	boolean	A’zolar ro’yxati Telegram’da mavjud bo’lsa true, yashirilgan bo’lsa false.
users	integer	A’zolar soni.
admins	massiv admin	Guruh administratorlari.
update	string (date-time) | null	Metama’lumotlarning oxirgi yangilanishi.
create	string (date-time) | null	Guruh bazaga qachon qo’shilgan.
shadow	boolean | null	Guruh a’zolari ro’yxati yashirilganini ko’rsatadi; qiymat noma’lum bo’lsa null.

History entry

Maydon	Tur	Tavsif
value	string	@username ning oldingi qiymati.
update	string (date-time) | null	@username qachon o’zgargan.

Admin

Maydon	Tur	Tavsif
id	integer	Admin foydalanuvchining ID si. To’liq profil uchun GET /v1/users/{identifier}.
role	string | null	admin, owner va h.k.
is_creator	boolean | null	Guruh yaratuvchisi uchun true.
update	string (date-time) | null	Admin yozuvi qachon tasdiqlangan.

Xatoliklar

• 404 — guruh topilmadi.
• 400 — noto’g’ri identifier.
• Qarang Xatoliklar.

Bog’liq metodlar

• O’xshash guruhlar.
• Foydalanuvchini olish — adminlarni hal qilish.