API Telegram Premium i Stars

Wysyłaj prezenty Telegram Premium i Telegram Stars z własnej aplikacji, bota lub sklepu. Proste API REST z JSON, jeden klucz API i zamówienia płatne z Twojego salda w tych samych cenach co na stronie.

Wprowadzenie

Utwórz konto i doładuj saldo na stronie Saldo.
Otwórz Moje konto, następnie API i utwórz swój klucz API. Jest on wyświetlany tylko raz, więc przechowuj go na swoim serwerze.
Wysyłaj klucz w nagłówku X-Api-Key z każdym żądaniem.

Utwórz swój klucz API

Podstawowy URL i format

Wszystkie żądania używają HTTPS i JSON. Odpowiedź sukcesu to { "ok": true, "data": ... }. Błąd to { "ok": false, "error": { "code", "message" } } ze stabilnym kodem.

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" } }

Endpointy

Metoda	Ścieżka	Funkcja
GET	/balance	Twoje saldo w USD
GET	/products	Czas trwania i ceny Premium, zakres i pakiety Stars
GET	/recipient?username=	Sprawdza nazwę użytkownika: osoba, kanał, grupa, bot lub nie znaleziono
POST	/quote	Cena zamówienia i czy Twoje saldo ją pokrywa
POST	/orders	Składa zamówienie na prezent płatne z salda
GET	/orders?limit=&batch=	Twoje ostatnie zamówienia (do 100)
GET	/orders/{code}	Jedno zamówienie według kodu

Składanie zamówienia

Premium: produkt "premium", miesiące 3, 6 lub 12, i do 10 username w odbiorcach. Stars: produkt "stars", stars od 3,500 do 550,000, i jeden username w odbiorcy. Całość jest pobierana z Twojego salda od razu i jedno zamówienie jest tworzone na odbiorcę.

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"}'

Kody błędów

Kod	Znaczenie
brakujący_api_key / nieprawidłowy_api_key	Brak klucza, klucz jest nieprawidłowy lub został zastąpiony (401)
nieprawidłowe_dane / nieprawidłowy_odbiorca	Sprawdź produkt, miesiące, gwiazdki lub nazwę użytkownika (400)
recipient_not_user	Nazwa użytkownika to kanał, grupa lub bot, albo nie istnieje
insufficient_credit	Saldo jest niższe niż wartość zamówienia; doładuj saldo
network_error	Tymczasowy błąd sieci; Twoje saldo się nie zmieniło, spróbuj ponownie
rate_limited	Ponad 120 żądań na minutę na klucz (429, zobacz Retry-After)

Limity i bezpieczeństwo

120 żądań na minutę na klucz; 60 sprawdzeń odbiorcy na 10 minut.
Jeden klucz na konto. Zastąpienie go natychmiast dezaktywuje stary klucz.
Przechowuj klucz na swoim serwerze. Nigdy nie umieszczaj go na stronie internetowej ani w aplikacji mobilnej.