API de Telegram Premium e Stars

Envie presentes de Telegram Premium e Telegram Stars do seu próprio app, bot ou loja. Uma pequena API REST com JSON, uma chave de API e pedidos pagos do seu saldo aos mesmos preços do site.

Começando

Crie uma conta e adicione saldo na página Saldo.
Abra Minha conta, depois API, e crie sua chave de API. Ela é mostrada apenas uma vez, então armazene-a no seu servidor.
Envie a chave no cabeçalho X-Api-Key com cada requisição.

Crie sua chave de API

URL base e formato

Todas as requisições usam HTTPS e JSON. Uma resposta de sucesso é { "ok": true, "data": ... }. Um erro responde { "ok": false, "error": { "code", "message" } } com um código estável.

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	Caminho	O que faz
GET	/balance	Seu saldo em USD
GET	/products	Durações e preços do Premium, faixa e pacotes de Stars
GET	/recipient?username=	Verifica um @username: pessoa, canal, grupo, bot ou não encontrado
POST	/quote	Preço de um pedido e se seu saldo cobre ele
POST	/orders	Faz um pedido de presente pago do saldo
GET	/orders?limit=&batch=	Seus pedidos recentes (até 100)
GET	/orders/{code}	Um pedido pelo seu código

Fazendo um pedido

Premium: produto "premium", meses 3, 6 ou 12, e até 10 usernames nos destinatários. Stars: produto "stars", stars de 3,500 a 550,000, e um username no destinatário. O total é debitado do seu saldo de uma vez e um pedido é feito por destinatário.

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 erro

Código	Significado
chave_api_ausente / chave_api_inválida	Sem chave, ou a chave está errada ou foi substituída (401)
entrada_inválida / destinatário_inválido	Verifique o produto, meses, estrelas ou nome de usuário (400)
recipient_not_user	O nome de usuário é um canal, grupo ou bot, ou não existe
insufficient_credit	O saldo é menor que o total do pedido; adicione crédito
network_error	Erro temporário de rede; seu saldo não foi alterado, tente novamente
rate_limited	Mais de 120 requisições por minuto por chave (429, veja Retry-After)

Limites e segurança

120 solicitações por minuto por chave; 60 verificações de destinatário a cada 10 minutos.
Uma chave por conta. Substituí-la interrompe a chave antiga imediatamente.
Mantenha a chave em seu servidor. Nunca a coloque em uma página da web ou aplicativo móvel.