Documentação da API

Base URL: https://sms.147-93-187-158.sslip.io. Autenticação: cabeçalho Authorization: Bearer SUA_CHAVE. Crie sua chave em API depois de entrar na conta.

Listar serviços

GET /api/v1/servicos
→ { "servicos": [ { "slug": "whatsapp", "name": "WhatsApp", "country": "br", "price_cents": 189 } ] }

Consultar saldo

GET /api/v1/saldo
→ { "saldo_cents": 2000 }

Comprar número

POST /api/v1/pedidos
Content-Type: application/json

{ "servico": "whatsapp" }

→ 201 { "id": "...", "numero": "+55 62 9XXXX-XXXX", "status": "active", "preco_cents": 189 }

Consultar pedido (código SMS)

GET /api/v1/pedidos/ID

→ { "id": "...", "numero": "...", "status": "received", "codigo": "123456", "sms": "...", "preco_cents": 189 }

Cancelar e reembolsar

POST /api/v1/pedidos/ID/cancelar
→ { "ok": true, "reembolso_cents": 189 }

Status do pedido

Status	Significado
active	Número alocado, aguardando SMS
received	Código recebido
cancelled	Cancelado por você, valor reembolsado
expired	Sem SMS em 20 min, valor reembolsado automaticamente

Valores em centavos (189 = R$ 1,89). Erros vêm como { "erro": "mensagem" } com HTTP 4xx.