API de Telegram Premium y Stars

Envía regalos de Telegram Premium y Telegram Stars desde tu propia aplicación, bot o tienda. Una pequeña API REST con JSON, una clave API y pedidos pagados desde tu saldo a los mismos precios que el sitio.

Cómo empezar

Crea una cuenta y añade saldo en la página de Saldo.
Abre Mi cuenta, luego API, y crea tu clave API. Solo se muestra una vez, así que guárdala en tu servidor.
Envía la clave en el encabezado X-Api-Key con cada solicitud.

Crea tu clave API

URL base y formato

Todas las solicitudes usan HTTPS y JSON. Una respuesta exitosa es { "ok": true, "data": ... }. Un error responde { "ok": false, "error": { "code", "message" } } con un código estable.

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étodo	Ruta	Qué hace
GET	/balance	Tu saldo en USD
GET	/products	Duración y precios de Premium, rangos y paquetes de Stars
GET	/recipient?username=	Verifica un nombre de usuario: persona, canal, grupo, bot o no encontrado
POST	/quote	Precio de un pedido y si tu saldo lo cubre
POST	/orders	Realiza un pedido de regalo pagado desde el saldo
GET	/orders?limit=&batch=	Tus pedidos recientes (hasta 100)
GET	/orders/{code}	Un pedido por su código

Realizar un pedido

Premium: producto "premium", meses 3, 6 o 12, y hasta 10 usernames en destinatarios. Stars: producto "stars", stars desde 3,500 hasta 550,000, y un username en destinatario. El total se toma de tu saldo al instante y se hace un pedido por 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"}'

Códigos de error

Código	Significado
clave_api_faltante / clave_api_inválida	Sin clave, o la clave es incorrecta o fue reemplazada (401)
entrada_inválida / destinatario_inválido	Verifica el producto, meses, estrellas o nombre de usuario (400)
recipient_not_user	El nombre de usuario es un canal, grupo o bot, o no existe
insufficient_credit	El saldo es menor que el total del pedido; recarga saldo
network_error	Error temporal de red; tu saldo no ha cambiado, intenta de nuevo
rate_limited	Más de 120 solicitudes por minuto por clave (429, ver Retry-After)

Límites y seguridad

120 solicitudes por minuto por clave; 60 verificaciones de destinatario cada 10 minutos.
Una clave por cuenta. Reemplazarla desactiva la clave anterior al instante.
Guarda la clave en tu servidor. Nunca la incluyas en una página web o aplicación móvil.