API de revenda
O mesmo contrato "API v2" que os painéis do setor já falam. Se o seu sistema hoje compra de outro fornecedor, trocar para cá é trocar a URL e a chave — nenhum código novo.
Como funciona o dinheiro
Não existe Pix por pedido na API — não há para onde mandar um programa pagar. Você recarrega o saldo antes (pelo Pix, na sua conta) e cada add debita na hora. Se o saldo não cobrir o pedido inteiro, ele é recusado: nada de pedido pendurado esperando pagamento no seu painel. Entrega parcial devolve a diferença em saldo automaticamente.
Ações
Catálogo — services
curl -X POST https://bombou.app.br/api/v2 \ -d key=SUA_CHAVE \ -d action=services
[
{
"service": 12,
"name": "Seguidores Instagram — Brasil",
"type": "Default",
"category": "Instagram — seguidores",
"rate": "31.90",
"min": "100",
"max": "10000",
"refill": true,
"cancel": false,
"dripfeed": false
}
]
rate é o preço de 1.000 unidades em reais, já com o seu desconto de revenda aplicado.
Criar pedido — add
curl -X POST https://bombou.app.br/api/v2 \ -d key=SUA_CHAVE \ -d action=add \ -d service=12 \ -d link=https://instagram.com/perfil \ -d quantity=1000
{ "order": 4193 }
O link é validado antes de qualquer débito — perfil onde o serviço espera perfil, publicação onde espera publicação, encurtador recusado. Erro aqui não gasta saldo.
Status — status
curl -X POST https://bombou.app.br/api/v2 \ -d key=SUA_CHAVE \ -d action=status \ -d order=4193
{
"charge": "31.90",
"start_count": "1420",
"status": "In progress",
"remains": "260",
"currency": "BRL"
}
Vários de uma vez: -d orders=4193,4194,4195 (até 100). Pedido que não é da sua conta volta como {"error": "Incorrect order ID"} dentro do mapa, em vez de sumir da resposta.
Reposição — refill
curl -X POST https://bombou.app.br/api/v2 -d key=SUA_CHAVE -d action=refill -d order=4193
Vale enquanto a garantia do serviço estiver vigente e só onde o provedor oferece reposição — o campo refill do catálogo diz quais.
Cancelar — cancel
curl -X POST https://bombou.app.br/api/v2 -d key=SUA_CHAVE -d action=cancel -d order=4193
Só enquanto o pedido não saiu daqui — uma janela de segundos, para desfazer um add disparado por engano. Depois de enviado ao provedor, quem decide é ele; o saldo volta na hora do cancelamento.
Saldo — balance
curl -X POST https://bombou.app.br/api/v2 -d key=SUA_CHAVE -d action=balance
{ "balance": "482.60", "currency": "BRL" }
Erros
Como manda o contrato do setor, erro vem com HTTP 200 e um campo error. Sempre teste o corpo, não o código HTTP:
{ "error": "Saldo insuficiente: o pedido custa R$ 31,90 e há R$ 12,00 na conta." }