ID yoki username bo'yicha foydalanuvchini olish

GET/v1/users/{identifier}1₽ yoki 4₽ har bir 2xx uchun

Raqamli ID yoki username bo’yicha foydalanuvchi profilini qaytaradi.

Avtorizatsiya

Api-Key sarlavhasi kerak.

Narxi

groups va cl_groups maydonlarining ikkalasi ham bo’sh bo’lsa, so’rov 1₽ turadi. Ulardan kamida bittasida guruh bo’lsa, so’rov 4₽ turadi.

Yo’l parametrlari

Nom	Tur	Majburiy	Tavsif
identifier	string	ha	Raqamli ID (masalan 12345) yoki @ bilan yoxud usiz username.

Misollar

cURL

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

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

Python

import os, requests

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

user = get_user("johndoe")

JavaScript

async function getUser(identifier) {
  const res = await fetch(
    `https://api.telesint.dev/v1/users/${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 user = await getUser('johndoe');

Javob — 200 OK

{
  "data": {
    "id": 12345,
    "username": "johndoe",
    "name": "John Doe",
    "h_name": [
      { "value": "John Doe Old", "update": "2021-01-01T00:00:00" },
      { "value": "John Doe Very Old", "update": null }
    ],
    "h_username": [
      { "value": "johndoe_old", "update": "2021-01-01T00:00:00" }
    ],
    "groups": [
      {
        "data": { "id": 12345, "title": "Example Group", "url": "example_group" },
        "admin": { "id": 12345, "is_creator": true, "role": "admin", "update": "2021-01-01T00:00:00" },
        "update": "2021-01-01T00:00:00"
      }
    ],
    "cl_groups": [],
    "scam": false,
    "dc": 2,
    "last_online": { "status": "recently", "update": "2021-01-01T00:00:00" },
    "premium": { "last_seen": "2021-01-01T00:00:00" },
    "is_bot": false,
    "is_deleted": false
  }
}

Maydonlar — data

Maydon	Tur	Tavsif
id	integer	O’zgarmas foydalanuvchi ID si.
username	string | null	Joriy username.
name	string	Joriy ko’rsatiladigan ism.
h_name	massiv history entry	Oldingi ismlar.
h_username	massiv history entry	Oldingi usernamelar.
groups	massiv group membership	Foydalanuvchining 1 000 tagacha ochiq guruhi.
cl_groups	massiv group membership	1 000 tagacha yopiq/shaxsiy guruh.
scam	boolean	Hisob scam deb belgilangan.
dc	integer | null	Datacenter raqami.
last_online	last online | null	Oxirgi onlayn holati.
premium	premium | null	Premium holati.
is_bot	boolean	Bot hisoblari uchun true.
is_deleted	boolean	Hisob o’chirilgan bo’lsa true.

History entry

Maydon	Tur	Tavsif
value	string	Ism yoki username ning oldingi qiymati.
update	string (date-time) | null	Bu qiymat qachon almashtirilgan.

Group membership

Maydon	Tur	Tavsif
data	object	{ id, title, url } — guruh haqida qisqa ma’lumot.
admin	object | null	Faqat foydalanuvchi guruh admini bo’lsa mavjud.
update	string (date-time) | null	A’zolik oxirgi marta qachon tasdiqlangan.

Last online

Maydon	Tur	Tavsif
status	enum	empty, online, offline, last_week, last_month, recently dan biri.
update	string (date-time) | null	Holat qachon yozilgan.

Premium

Maydon	Tur	Tavsif
last_seen	string (date-time) | null	Hisobda oxirgi marta premium qachon qayd etilgan.

Xatoliklar

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