Telegram Premium und Stars API

Senden Sie Telegram Premium und Telegram Stars Geschenke über Ihre eigene App, Ihren Bot oder Ihren Shop. Eine kleine REST API mit JSON, einem API-Schlüssel und Bestellungen, die zu den gleichen Preisen wie auf der Website von Ihrem Guthaben bezahlt werden.

Erste Schritte

Erstellen Sie ein Konto und fügen Sie Guthaben auf der Guthaben-Seite hinzu.
Öffnen Sie Mein Konto, dann API und erstellen Sie Ihren API-Schlüssel. Er wird einmal angezeigt, speichern Sie ihn also auf Ihrem Server.
Senden Sie den Schlüssel im X-Api-Key-Header mit jeder Anfrage.

API-Schlüssel erstellen

Basis-URL und Format

Alle Anfragen verwenden HTTPS und JSON. Eine erfolgreiche Antwort lautet { "ok": true, "data": ... }. Ein Fehler antwortet mit { "ok": false, "error": { "code", "message" } } mit einem stabilen Code.

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

Endpunkte

Methode	Pfad	Funktion
GET	/balance	Ihr Guthaben in USD
GET	/products	Premium-Dauern und Preise, Stars-Bereich und Pakete
GET	/recipient?username=	Überprüft einen Benutzernamen: Person, Kanal, Gruppe, Bot oder nicht gefunden
POST	/quote	Preis einer Bestellung und ob Ihr Guthaben dies abdeckt
POST	/orders	Gibt eine Geschenkbestellung auf, die vom Guthaben bezahlt wird
GET	/orders?limit=&batch=	Ihre letzten Bestellungen (bis zu 100)
GET	/orders/{code}	Eine Bestellung anhand ihres Codes

Bestellung aufgeben

Premium: Produkt "premium", Monate 3, 6 oder 12, und bis zu 10 Usernamen in Empfängern. Stars: Produkt "stars", Stars von 3,500 bis 550,000, und ein Username im Empfänger. Der Gesamtbetrag wird sofort von Ihrem Guthaben abgezogen und eine Bestellung pro Empfänger erstellt.

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

Fehlercodes

Code	Bedeutung
fehlender_api_schlüssel / ungültiger_api_schlüssel	Kein Schlüssel oder der Schlüssel ist falsch oder wurde ersetzt (401)
ungültige_eingabe / ungültiger_empfänger	Überprüfen Sie das Produkt, die Monate, Stars oder den Benutzernamen (400)
recipient_not_user	Der Benutzername ist ein Kanal, eine Gruppe oder ein Bot oder existiert nicht
insufficient_credit	Guthaben ist niedriger als der Bestellbetrag; Guthaben aufladen
network_error	Vorübergehender Netzwerkfehler; Ihr Guthaben hat sich nicht geändert, versuchen Sie es erneut
rate_limited	Über 120 Anfragen pro Minute pro Schlüssel (429, siehe Retry-After)

Limits und Sicherheit

120 Anfragen pro Minute pro Schlüssel; 60 Empfängerprüfungen alle 10 Minuten.
Ein Schlüssel pro Konto. Das Ersetzen stoppt den alten Schlüssel sofort.
Bewahren Sie den Schlüssel auf Ihrem Server auf. Geben Sie ihn niemals auf einer Webseite oder in einer mobilen App ein.