API Telegram Premium dan Stars

Hantar hadiah Telegram Premium dan Telegram Stars dari aplikasi, bot atau kedai anda sendiri. API REST kecil dengan JSON, satu kunci API, dan pesanan dibayar dari kredit anda pada harga yang sama dengan laman web.

Permulaan

Buat akaun dan tambah kredit pada halaman Kredit.
Buka Akaun Saya, kemudian API, dan buat kunci API anda. Ia hanya ditunjukkan sekali, jadi simpan di pelayan anda.
Hantar kunci dalam header X-Api-Key dengan setiap permintaan.

Buat kunci API anda

URL asas dan format

Semua permintaan menggunakan HTTPS dan JSON. Jawapan kejayaan ialah { "ok": true, "data": ... }. Jawapan ralat ialah { "ok": false, "error": { "code", "message" } } dengan kod 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" } }

Titik akhir

Kaedah	Laluan	Fungsinya
GET	/balance	Kredit anda dalam USD
GET	/products	Tempoh dan harga Premium, julat dan pakej Stars
GET	/recipient?username=	Menyemak nama pengguna: orang, saluran, kumpulan, bot atau tidak ditemui
POST	/quote	Harga pesanan dan sama ada kredit anda mencukupi
POST	/orders	Membuat pesanan hadiah yang dibayar dari kredit
GET	/orders?limit=&batch=	Pesanan terkini anda (sehingga 100)
GET	/orders/{code}	Satu pesanan mengikut kodnya

Membuat pesanan

Premium: produk "premium", bulan 3, 6 atau 12, dan sehingga 10 username dalam penerima. Stars: produk "stars", stars dari 3,500 hingga 550,000, dan satu username dalam penerima. Jumlah diambil dari kredit anda serta-merta dan satu pesanan dibuat untuk setiap 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"}'

Kod ralat

Kod	Maksud
kekunci_api_tiada / kekunci_api_tidak_sah	Tiada kunci, atau kunci salah atau telah diganti (401)
input_tidak_sah / penerima_tidak_sah	Periksa produk, bulan, bintang atau nama pengguna (400)
recipient_not_user	Nama pengguna adalah saluran, kumpulan atau bot, atau tidak wujud
insufficient_credit	Saldo tidak mencukupi untuk pesanan; tambah saldo
network_error	Ralat rangkaian sementara; saldo anda tidak berubah, cuba lagi
rate_limited	Lebih dari 120 permintaan seminit setiap kunci (429, lihat Retry-After)

Had dan keselamatan

120 permintaan seminit setiap kunci; 60 semakan penerima setiap 10 minit.
Satu kunci setiap akaun. Menggantinya akan menghentikan kunci lama serta-merta.
Simpan kunci pada pelayan anda. Jangan letakkannya dalam halaman web atau aplikasi mudah alih.