API Telegram Premium et Stars

Envoyez des cadeaux Telegram Premium et Telegram Stars depuis votre propre application, bot ou boutique. Une petite API REST avec JSON, une clé API, et des commandes payées depuis votre crédit aux mêmes prix que le site.

Premiers pas

Créez un compte et ajoutez du crédit sur la page Crédit.
Ouvrez Mon compte, puis API, et créez votre clé API. Elle n'est affichée qu'une fois, alors stockez-la sur votre serveur.
Envoyez la clé dans l'en-tête X-Api-Key avec chaque requête.

Créer votre clé API

URL de base et format

Toutes les requêtes utilisent HTTPS et JSON. Une réponse de succès est { "ok": true, "data": ... }. Une erreur répond { "ok": false, "error": { "code", "message" } } avec un code stable.

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

Endpoints

Méthode	Chemin	Fonction
GET	/balance	Votre crédit en USD
GET	/products	Durées et prix de Premium, gamme et packs de Stars
GET	/recipient?username=	Vérifie un nom d'utilisateur : personne, canal, groupe, bot ou non trouvé
POST	/quote	Prix d'une commande et si votre crédit le couvre
POST	/orders	Passe une commande de cadeau payée depuis le crédit
GET	/orders?limit=&batch=	Vos commandes récentes (jusqu'à 100)
GET	/orders/{code}	Une commande par son code

Passer une commande

Premium : produit "premium", mois 3, 6 ou 12, et jusqu'à 10 usernames dans les destinataires. Stars : produit "stars", stars de 3,500 à 550,000, et un username dans le destinataire. Le total est prélevé de votre solde immédiatement et une commande est faite par destinataire.

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

Codes d'erreur

Code	Signification
clé_api_manquante / clé_api_invalide	Pas de clé, ou la clé est incorrecte ou a été remplacée (401)
entrée_invalide / destinataire_invalide	Vérifiez le produit, les mois, les Stars ou le nom d'utilisateur (400)
recipient_not_user	Le nom d'utilisateur est un canal, un groupe ou un bot, ou n'existe pas
insufficient_credit	Le solde est inférieur au total de la commande ; ajoutez du crédit
network_error	Erreur réseau temporaire ; votre solde n'a pas changé, réessayez
rate_limited	Plus de 120 requêtes par minute par clé (429, voir Retry-After)

Limites et sécurité

120 requêtes par minute par clé ; 60 vérifications de destinataire par 10 minutes.
Une clé par compte. La remplacer désactive immédiatement l'ancienne clé.
Conservez la clé sur votre serveur. Ne la mettez jamais dans une page web ou une application mobile.