Introdução
O que a API de revenda faz, onde ela fica e como as respostas chegam.
A API de revenda deixa o seu sistema fazer sozinho o que você faz no painel: consultar o catálogo e o saldo, gerar keys e resetar HWID. Uma loja, um bot do Discord ou um sistema de pedidos pode entregar a key ao cliente na hora da venda, sem ninguém abrir o painel.
Listar produtos
Os mods liberados e o preço de cada key.
Gerar keys
Cria keys e desconta do saldo.
Resetar HWID
Libera a key para outro computador.
Ver saldo
Saldo e extrato de créditos.
Endereço da API
Todas as chamadas começam pelo mesmo endereço. Ele aparece no painel, em API › Tokens, no exemplo de uso.
Os exemplos desta documentação leem o endereço e o token de duas variáveis de ambiente:
export PROJECT_API_URL="cole aqui o endereço do painel"
export PROJECT_TOKEN="prj_live_..."Não existe ambiente de teste
Toda chamada usa o seu saldo de verdade. Gere key só quando for entregar para um cliente.
Formato das respostas
Toda resposta é JSON e tem sempre os mesmos campos:
| Campo | O que é |
|---|---|
success | true quando deu certo, false quando deu erro. |
message | Texto para mostrar ou registrar, quase sempre em português. |
data | Os dados da resposta (só quando deu certo). |
errors | Os detalhes do erro (só quando deu errado). |
{
"success": true,
"message": "Saldo carregado.",
"data": { "balance": 480 }
}{
"success": false,
"message": "Créditos insuficientes.",
"errors": { "balance": 12 }
}As respostas podem trazer campos além dos descritos aqui. Ignore os que o seu sistema não conhece.
Datas, prazos e valores
- Datas como
created_atvêm no formatoAAAA-MM-DD HH:MM:SS. - Prazos como
access_endvêm em segundos desde 1970 (Unix). - Créditos são sempre números inteiros.