API para revendedores

Um único endpoint, um formulário com os campos key e action. Compatível com a API v2 padrão de painéis SMM — módulos prontos de lojas e sistemas de cobrança se conectam sem alterações.

Início rápido

Endereço: https://telegos.app/api/v2
Método: POST
Formato do corpo: application/x-www-form-urlencoded
Resposta: JSON, sempre com status 200

A chave é enviada no campo key do corpo da requisição — o cabeçalho Authorization não é usado aqui. Sua conta funciona com um token separado, então redefinir a chave não encerra sua sessão no navegador.

Lista de serviços

Retorna a tabela de preços completa: o id do serviço para action=add, o preço por 1000 e os limites de quantidade.

Campo	Valor
`key`	Sua chave
`action`	services

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=services

Resposta

[
  {
    "service": 101,
    "name": "Telegram Members · CIS",
    "type": "Default",
    "category": "Telegram Members",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Criar um pedido

Debita o valor do saldo na hora e retorna o número do pedido.

Campo	Valor
`key`	Sua chave
`action`	add
`service`	id do serviço obtido em action=services
`link`	Link do canal, post ou perfil
`quantity`	Quantidade do pedido dentro de min…max

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=500

Resposta

{
  "order": 23501
}

Pedido com entrega gradual (drip-feed)

Os mesmos campos e mais dois: quantas execuções fazer e o intervalo entre elas. Aqui quantity é a quantidade de uma única execução, e é cobrado o total de todas as execuções.

Campo	Valor
`runs`	Número de execuções
`interval`	Intervalo entre execuções em minutos

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=100 \
  -d runs=5 \
  -d interval=60

Resposta

{
  "order": 23502
}

Status do pedido

start_count é o contador no início, remains é quanto ainda falta entregar.

Campo	Valor
`key`	Sua chave
`action`	status
`order`	Número do pedido

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501

Resposta

{
  "charge": "0.4500",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}

Status de vários pedidos

Até 100 números por requisição. A resposta é um objeto indexado pelo número do pedido: um pedido inexistente vem com error e não afeta os demais.

Campo	Valor
`key`	Sua chave
`action`	status
`orders`	Números separados por vírgula

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,999999

Resposta

{
  "23501": {
    "charge": "0.4500",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.9000",
    "start_count": "1204",
    "status": "In progress",
    "remains": "300",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}

Reposição

Disponível quando o serviço retorna refill: true. O andamento da reposição é consultado pela ação separada refill_status, usando o número dela.

Campo	Valor
`key`	Sua chave
`action`	refill / refill_status
`order`	Número do pedido — para refill
`refill`	Número da reposição — para refill_status

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501

Resposta

{
  "refill": 412
}

Cancelamento

Disponível quando o serviço retorna cancel: true. O valor dos pedidos cancelados volta para o saldo.

Campo	Valor
`key`	Sua chave
`action`	cancel
`orders`	Números separados por vírgula

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=23501,23502

Resposta

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]

Saldo

Campo	Valor
`key`	Sua chave
`action`	balance

Requisição

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=balance

Resposta

{
  "balance": "19.61",
  "currency": "USD"
}

Status dos pedidos

Status	O que significa
`Pending`	O pedido foi aceito e aguarda envio ao fornecedor
`In progress`	A entrega está em andamento
`Processing`	O pedido está sendo processado pelo fornecedor
`Completed`	A quantidade foi entregue por completo
`Partial`	Parte da quantidade foi entregue, o restante voltou para o saldo
`Canceled`	O pedido foi cancelado, o valor debitado foi devolvido

Erros

Um erro chega com o mesmo código 200 e se distingue pela presença do campo error: verifique o corpo, não o status da resposta. Em ações em lote, o erro fica dentro do próprio elemento e não cancela os demais.

Resposta

{
  "error": "Incorrect request"
}