Telegram Premium at Stars API

Magpadala ng Telegram Premium at Telegram Stars gifts mula sa iyong sariling app, bot o shop. Isang simpleng REST API na may JSON, isang API key, at mga order na babayaran mula sa iyong credit sa parehong presyo sa site.

Paano magsimula

Gumawa ng account at magdagdag ng credit sa Credit page.
Buksan ang My account, piliin ang API, at gumawa ng iyong API key. Ito ay ipapakita minsan lamang, kaya itago ito sa iyong server.
Ipadala ang key sa X-Api-Key header sa bawat request.

Gumawa ng iyong API key

Base URL at format

Lahat ng request ay gumagamit ng HTTPS at JSON. Ang successful na sagot ay { "ok": true, "data": ... }. Ang error ay { "ok": false, "error": { "code", "message" } } na may stable code.

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

Mga endpoint

Paraan	Path	Paggamit
GET	/balance	Ang iyong credit sa USD
GET	/products	Mga tagal at presyo ng Premium, range at package ng Stars
GET	/recipient?username=	Tinitiyak ang username: tao, channel, grupo, bot o hindi makita
POST	/quote	Presyo ng order at kung sapat ang iyong credit
POST	/orders	Gumagawa ng gift order na babayaran mula sa credit
GET	/orders?limit=&batch=	Ang iyong mga kamakailang order (hanggang 100)
GET	/orders/{code}	Isang order gamit ang code nito

Pag-order

Premium: product "premium", buwan 3, 6 o 12, at hanggang 10 username sa recipients. Stars: product "stars", stars mula 3,500 hanggang 550,000, at isang username sa recipient. Ang kabuuan ay kukunin mula sa iyong credit kaagad at isang order ang gagawin kada recipient.

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

Mga error code

Code	Kahulugan
nawawalang_api_key / hindi-wastong_api_key	Walang key, o mali ang key o pinalitan (401)
invalid_input / invalid_recipient	Suriin ang produkto, buwan, stars o username (400)
recipient_not_user	Ang username ay isang channel, group o bot, o hindi umiiral
insufficient_credit	Ang credit ay mas mababa sa kabuuang order; magdagdag ng credit
network_error	Pansamantalang network error; hindi nagbago ang iyong credit, subukan muli
rate_limited	Higit sa 120 request kada minuto kada key (429, tingnan ang Retry-After)

Mga limitasyon at kaligtasan

120 requests kada minuto bawat key; 60 recipient checks kada 10 minuto.
Isang key bawat account. Kapag pinalitan, agad itong titigil sa lumang key.
Panatilihin ang key sa iyong server. Huwag kailanman ilagay ito sa web page o mobile app.