Telegram Premium ve Stars API
Kendi uygulamanızdan, botunuzdan veya mağazanızdan Telegram Premium ve Telegram Stars hediyeleri gönderin. JSON ile küçük bir REST API, tek bir API anahtarı ve sitedekiyle aynı fiyatlardan kredinizle ödenen siparişler.
Başlarken
- Hesap oluşturun ve Bakiye sayfasından bakiye ekleyin.
- Hesabım'ı açın, ardından API'ye gidin ve API anahtarınızı oluşturun. Anahtar yalnızca bir kez gösterilir, bu yüzden sunucunuzda saklayın.
- Her istekte X-Api-Key başlığı ile anahtarı gönderin.
Temel URL ve format
Tüm istekler HTTPS ve JSON kullanır. Başarılı bir yanıt { "ok": true, "data": ... } şeklindedir. Bir hata yanıtı { "ok": false, "error": { "code", "message" } } şeklinde sabit bir kodla döner.
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" } }Uç noktalar
| Yöntem | Yol | Ne yapar |
|---|---|---|
| GET | /balance | USD cinsinden bakiyeniz |
| GET | /products | Premium süreleri ve fiyatları, Stars aralığı ve paketleri |
| GET | /recipient?username= | Bir kullanıcı adını kontrol eder: kişi, kanal, grup, bot veya bulunamadı |
| POST | /quote | Bir siparişin fiyatı ve bakiyenizin yeterli olup olmadığı |
| POST | /orders | Kredinizden ödenen bir hediye siparişi verir |
| GET | /orders?limit=&batch= | Son siparişleriniz (en fazla 100) |
| GET | /orders/{code} | Koduna göre bir sipariş |
Sipariş verme
Premium: ürün "premium", 3, 6 veya 12 ay ve alıcılarda en fazla 10 kullanıcı adı. Stars: ürün "stars", 3,500 ile 550,000 arasında Stars ve alıcıda bir kullanıcı adı. Toplam bakiyenizden bir seferde alınır ve her alıcı için bir sipariş oluşturulur.
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"}'Hata kodları
| Kod | Anlamı |
|---|---|
| eksik_api_anahtari / geçersiz_api_anahtari | Anahtar yok veya anahtar yanlış ya da değiştirilmiş (401) |
| geçersiz_girdi / geçersiz_alıcı | Ürünü, ayları, yıldızları veya kullanıcı adını kontrol edin (400) |
| recipient_not_user | Kullanıcı adı bir kanal, grup veya bot veya mevcut değil |
| insufficient_credit | Bakiye sipariş tutarından düşük; bakiye ekleyin |
| network_error | Geçici ağ hatası; bakiyeniz değişmedi, tekrar deneyin |
| rate_limited | Anahtar başına dakikada 120 istekten fazla (429, Retry-After'a bakın) |
Limitler ve güvenlik
- Dakikada anahtar başına 120 istek; 10 dakikada 60 alıcı kontrolü.
- Hesap başına bir anahtar. Değiştirmek eski anahtarı anında durdurur.
- Anahtarınızı sunucunuzda saklayın. Asla bir web sayfasına veya mobil uygulamaya koymayın.