API per Telegram Premium e Stars
Invia regali di Telegram Premium e Telegram Stars dalla tua app, bot o negozio. Una piccola API REST con JSON, una chiave API e ordini pagati dal tuo credito agli stessi prezzi del sito.
Per iniziare
- Crea un account e aggiungi credito nella pagina Credito.
- Apri Il mio account, poi API, e crea la tua chiave API. Viene mostrata una sola volta, quindi conservala sul tuo server.
- Invia la chiave nell'intestazione X-Api-Key con ogni richiesta.
URL base e formato
Tutte le richieste utilizzano HTTPS e JSON. Una risposta di successo è { "ok": true, "data": ... }. Un errore risponde con { "ok": false, "error": { "code", "message" } } con un codice stabile.
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
| Metodo | Percorso | Funzione |
|---|---|---|
| GET | /balance | Il tuo credito in USD |
| GET | /products | Durata e prezzi di Premium, intervallo e pacchetti di Stars |
| GET | /recipient?username= | Verifica un nome utente: persona, canale, gruppo, bot o non trovato |
| POST | /quote | Prezzo di un ordine e se il tuo credito lo copre |
| POST | /orders | Effettua un ordine di regalo pagato dal credito |
| GET | /orders?limit=&batch= | I tuoi ordini recenti (fino a 100) |
| GET | /orders/{code} | Un ordine tramite il suo codice |
Effettuare un ordine
Premium: prodotto "premium", mesi 3, 6 o 12, e fino a 10 username nei destinatari. Stars: prodotto "stars", stars da 3,500 a 550,000, e un username nel destinatario. Il totale viene prelevato dal tuo credito immediatamente e viene creato un ordine per destinatario.
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"}'Codici di errore
| Codice | Significato |
|---|---|
| chiave_api_mancante / chiave_api_non_valida | Nessuna chiave, la chiave è errata o è stata sostituita (401) |
| input_non_valido / destinatario_non_valido | Controlla il prodotto, i mesi, le stelle o il nome utente (400) |
| recipient_not_user | Il nome utente è un canale, un gruppo o un bot, oppure non esiste |
| insufficient_credit | Il credito è inferiore al totale dell'ordine; aggiungi credito |
| network_error | Errore temporaneo di rete; il tuo credito non è cambiato, riprova |
| rate_limited | Oltre 120 richieste al minuto per chiave (429, vedi Retry-After) |
Limiti e sicurezza
- 120 richieste al minuto per chiave; 60 controlli destinatario ogni 10 minuti.
- Una chiave per account. Sostituirla disattiva immediatamente la vecchia chiave.
- Mantieni la chiave sul tuo server. Non inserirla mai in una pagina web o in un'app mobile.