Отримати користувача за ID або username

GET/v1/users/{identifier}1₽ або 4₽ за 2xx

Повертає профіль користувача за числовим ID або username.

Авторизація

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

Вартість

Запит коштує 1₽, якщо обидва поля — groups і cl_groups — порожні. Якщо хоча б одне з них містить групу, запит коштує 4₽.

Параметри шляху

Ім’я	Тип	Обов’язковий	Опис
identifier	string	так	Числовий ID (наприклад 12345) або username з @ чи без нього.

Приклади

cURL

# За числовим ID
curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/users/12345

# За username
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');

Відповідь — 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
  }
}

Поля — data

Поле	Тип	Опис
id	integer	Незмінний ID користувача.
username	string | null	Поточний username.
name	string	Поточне ім’я для відображення.
h_name	масив history entry	Попередні імена.
h_username	масив history entry	Попередні usernames.
groups	масив group membership	До 1 000 відкритих груп користувача.
cl_groups	масив group membership	До 1 000 закритих/приватних груп.
scam	boolean	Акаунт позначено як scam.
dc	integer | null	Номер датацентру.
last_online	last online | null	Останній онлайн-статус.
premium	premium | null	Преміум-статус.
is_bot	boolean	true для бот-акаунтів.
is_deleted	boolean	true якщо акаунт видалений.

History entry

Поле	Тип	Опис
value	string	Попереднє значення імені або username.
update	string (date-time) | null	Коли це значення було замінено.

Group membership

Поле	Тип	Опис
data	object	{ id, title, url } — коротка інформація про групу.
admin	object | null	Присутній, тільки якщо користувач — адмін групи.
update	string (date-time) | null	Коли членство востаннє підтвердили.

Last online

Поле	Тип	Опис
status	enum	Одне з empty, online, offline, last_week, last_month, recently.
update	string (date-time) | null	Коли статус було записано.

Premium

Поле	Тип	Опис
last_seen	string (date-time) | null	Коли в акаунта востаннє був зафіксований преміум.

Помилки

• 404 — користувача не знайдено.
• 400 — некоректний identifier.
• Див. Помилки.