API предназначен для автоматизации покупки групп. Подходит людям и агентам. Методы доступны без авторизации в панели — достаточно API-ключа.

🔑 Получение ключа

Ключ создаётся в личном кабинете: 🔑 API-ключи (после входа). Ключ можно остановить, возобновить или удалить; по каждому ключу ведётся статистика использований.

🛒 1. Покупка группы

Создаёт заказ на группу от имени вашего профиля покупателя (профиль по умолчанию или указанный profile_id).

curl "https://ВАШ_ДОМЕН/tg_shop/api.php?action=purchase&key=ВАШ_КЛЮЧ&item_id=5"

Ответ:

{"ok":true,"order_id":42,"item":"@BrevCore","price_stars":100,"auto_transfer":true,"next":"Проверьте статус..."}

📦 2. Статус заказа

curl "https://ВАШ_ДОМЕН/tg_shop/api.php?action=status&key=ВАШ_КЛЮЧ&order_id=42"

Поля статуса: status (new/paid/done/cancelled), transfer_status (none/pending/transferred/failed), transfer_error.

📋 3. Список групп (с фильтрами)

Возвращает каталог групп с учётом фильтров. Доступен по API-ключу.

curl "https://ВАШ_ДОМЕН/tg_shop/api.php?action=items&key=ВАШ_КЛЮЧ&status=available&q=brev&min_len=4&max_len=12&sort=price&per_page=20&page=1"

Параметры фильтра:

Параметр	Описание	По умолчанию
status	Фильтр по статусу: available (в продаже) · sold (продано/зарезервировано) · all (все)	available
q	Поиск по названию (LIKE %q%)	—
min_len	Минимальная длина имени (букв)	0
max_len	Максимальная длина имени (букв)	0
sort	Сортировка: new · len (длина ↑) · len_desc · name (алфавит) · price	new
per_page	Кол-во на страницу (1–100)	20
page	Номер страницы	1

Ответ:

{"ok":true,"total":128,"page":1,"pages":7,"per_page":20,
 "filters":{"q":"brev","min_len":4,"max_len":12,"status":"available","sort":"price"},
 "data":[{"id":5,"name":"BrevCore","url":"https://t.me/BrevCore","price_stars":100,
          "status":"available","comment":"","created_at":"...","sold_at":null}]}

⚠️ Ошибки

401 — нет ключа · 403 — недействительный/остановленный ключ или заблокированный аккаунт · {"ok":false,"error":"..."} — логические ошибки (группа продана, нет профиля, группа не найдена у юзербота).