★ API

API de Telegram Stars: início rápido em Python

Um fluxo mínimo e seguro para produção em Python com a biblioteca requests.

Entrega automáticaa maioria dos pedidos em minutos
Verificação de nome de usuárioantes de pagar
Preços abertosiguais no site e na API
Registro públicotodo pedido recebe um TxId
import os, uuid, requests

API = "https://paystars.uz/api/v1"
H = {"X-API-Key": os.environ["PAYSTARS_API_KEY"]}

chk = requests.post(f"{API}/check-username", headers=H,
                    json={"username": "durov", "kind": "stars"}).json()
order = requests.post(f"{API}/stars/buy",
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())},
                      json={"username": "durov", "quantity": 50,
                            "verification_token": chk["verification_token"]}).json()
print(requests.get(f"{API}/order/{order['order_id']}", headers=H).json())
  • Guarde a Idempotency-Key com o seu pedido e reutilize-a nas novas tentativas — a API nunca cobra duas vezes.
  • Respeite o limite de 10 requisições/segundo por chave; recue em HTTP 429.

Perguntas frequentes

Existe um ambiente de testes?

Use pedidos reais pequenos (50 Stars) durante a integração; a chave de idempotência torna as novas tentativas seguras.

Quais linguagens são compatíveis?

Qualquer linguagem com HTTPS. Veja os guias rápidos de Python, Node.js e PHP.

As chaves de API expiram?

Não. As chaves permanecem válidas até que você as revogue no painel.

Posso pagar em USD?

Sim — recarregue o saldo em USD com USDT (TON, BEP20 ou TRC20) e envie currency=USD.

Pronto para pedir?

Entre com o Telegram — seu saldo StarKerak funciona no site, no WebApp e pela API.