API для Telegram Premium та Telegram Stars

Надсилайте подарунки Telegram Premium та Telegram Stars зі своєї програми, бота або магазину. Простий REST API з JSON, один API-ключ та замовлення, оплачені з вашого кредиту за тими ж цінами, що й на сайті.

Початок роботи

Створіть обліковий запис і поповніть кредит на сторінці Кредит.
Відкрийте Мій акаунт, потім API та створіть свій API-ключ. Він показується один раз, тому збережіть його на своєму сервері.
Надсилайте ключ у заголовку X-Api-Key з кожним запитом.

Створіть ваш API ключ

Базовий URL та формат

Усі запити використовують HTTPS та JSON. Успішна відповідь: { "ok": true, "data": ... }. Помилка: { "ok": false, "error": { "code", "message" } } зі стабільним кодом.

https://buytgpremium.com/api/v1

curl https://buytgpremium.com/api/v1/balance \
  -H "X-Api-Key: btk_YOUR_KEY"

{ "ok": true, "data": { "credit": "120.00", "currency": "USD" } }

Кінцеві точки

Спосіб	Шлях	Що робить
GET	/balance	Ваш кредит у USD
GET	/products	Тривалість та ціни Premium, діапазон та пакети Stars
GET	/recipient?username=	Перевіряє ім'я користувача: людина, канал, група, бот або не знайдено
POST	/quote	Вартість замовлення та чи достатньо вашого кредиту
POST	/orders	Розміщує замовлення на подарунок, оплачене з кредиту
GET	/orders?limit=&batch=	Ваші останні замовлення (до 100)
GET	/orders/{code}	Одне замовлення за його кодом

Розміщення замовлення

Premium: продукт "premium", місяці 3, 6 або 12, та до 10 username у отримувачах. Stars: продукт "stars", stars від 3,500 до 550,000, та один username у отримувачі. Сума списується з вашого балансу миттєво, і для кожного отримувача створюється окреме замовлення.

curl -X POST https://buytgpremium.com/api/v1/orders \
  -H "X-Api-Key: btk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"premium","months":12,"recipients":["alice","bob"]}'

{ "ok": true, "data": { "batch": "B-7KQ2-...", "total": "34.00", "currency": "USD",
  "orders": [ { "code": "G-4MZ8-...", "product": "premium", "recipient": "alice", "months": 12,
    "price": "17.00", "status": "completed" }, ... ] } }

curl -X POST https://buytgpremium.com/api/v1/orders \
  -H "X-Api-Key: btk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"stars","stars":5000,"recipient":"alice"}'

Коди помилок

Код	Значення
відсутній_ключ_api / недійсний_ключ_api	Відсутній ключ, ключ неправильний або був замінений (401)
неправильний ввід / неправильний отримувач	Перевірте продукт, місяці, зірки або ім'я користувача (400)
recipient_not_user	Ім'я користувача є каналом, групою або ботом, або не існує
insufficient_credit	Баланс менший за загальну суму замовлення; поповніть баланс
network_error	Тимчасова помилка мережі; ваш баланс не змінився, спробуйте ще раз
rate_limited	Понад 120 запитів на хвилину на ключ (429, див. Retry-After)

Обмеження та безпека

120 запитів на хвилину на ключ; 60 перевірок отримувача на 10 хвилин.
Один ключ на акаунт. Заміна ключа негайно зупиняє старий ключ.
Зберігайте ключ на вашому сервері. Ніколи не додавайте його до веб-сторінки чи мобільного додатку.