API Telegram Premium dan Stars

Kirim hadiah Telegram Premium dan Telegram Stars dari aplikasi, bot, atau toko Anda sendiri. API REST kecil dengan JSON, satu kunci API, dan pesanan dibayar dari saldo Anda dengan harga yang sama seperti di situs.

Memulai

Buat akun dan tambahkan saldo di halaman Kredit.
Buka Akun Saya, lalu API, dan buat kunci API Anda. Kunci ini hanya ditampilkan sekali, jadi simpan di server Anda.
Kirim kunci dalam header X-Api-Key dengan setiap permintaan.

Buat kunci API Anda

URL dasar dan format

Semua permintaan menggunakan HTTPS dan JSON. Jawaban sukses { "ok": true, "data": ... }. Jawaban error { "ok": false, "error": { "code", "message" } } dengan kode yang stabil.

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

Endpoint

Metode	Path	Fungsinya
GET	/balance	Saldo Anda dalam USD
GET	/products	Durasi dan harga Premium, rentang dan paket Stars
GET	/recipient?username=	Memeriksa username: orang, channel, grup, bot, atau tidak ditemukan
POST	/quote	Harga pesanan dan apakah saldo Anda mencukupi
POST	/orders	Memesan hadiah yang dibayar dari saldo
GET	/orders?limit=&batch=	Pesanan terbaru Anda (hingga 100)
GET	/orders/{code}	Satu pesanan berdasarkan kodenya

Memesan

Premium: produk "premium", bulan 3, 6, atau 12, dan hingga 10 username dalam penerima. Stars: produk "stars", stars dari 3,500 hingga 550,000, dan satu username dalam penerima. Total diambil dari kredit Anda langsung dan satu pesanan dibuat per penerima.

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

Kode error

Kode	Arti
kunci_api_tidak_ada / kunci_api_tidak_valid	Tidak ada kunci, atau kunci salah atau diganti (401)
input_tidak_valid / penerima_tidak_valid	Periksa produk, bulan, Stars, atau @username (400)
recipient_not_user	@username adalah channel, grup, atau bot, atau tidak ada
insufficient_credit	Saldo tidak mencukupi total pesanan; tambahkan saldo
network_error	Kesalahan jaringan sementara; saldo Anda tidak berubah, coba lagi
rate_limited	Lebih dari 120 permintaan per menit per kunci (429, lihat Retry-After)

Batasan dan keamanan

120 permintaan per menit per kunci; 60 pemeriksaan penerima per 10 menit.
Satu kunci per akun. Menggantinya akan menghentikan kunci lama segera.
Simpan kunci di server Anda. Jangan pernah memasukkannya ke halaman web atau aplikasi seluler.