API

Compatível com o protocolo SMS-Activate: programas e bots feitos para ele funcionam trocando a URL e a chave. Valores em reais, descontados do seu saldo. Gere a chave em Conta.

Endereço

https://sms.svizia.com/stubs/handler_api.php?api_key=SUA_CHAVE&action=…

GET ou POST. País: id numérico do protocolo (Brasil = 73, veja getCountries) ou o código de 2 letras (br). Serviço: código do protocolo (wa WhatsApp, tg Telegram, ig Instagram, go Google…; veja getServicesList).

action	parâmetros	resposta
getBalance	—	ACCESS_BALANCE:25.40 (em reais)
getNumber	service, country, maxPrice (opcional, em reais)	ACCESS_NUMBER:184032:5511912345678 · NO_NUMBERS · NO_BALANCE · WRONG_MAX_PRICE:0.35
getNumberV2	igual ao getNumber	JSON com activationId, phoneNumber, activationCost, currency
getStatus	id	STATUS_WAIT_CODE · STATUS_OK:948010 · STATUS_WAIT_RETRY:948010 · STATUS_CANCEL
setStatus	id, status (8 cancelar · 3 outro SMS · 6 concluir · 1 pronto)	ACCESS_CANCEL · EARLY_CANCEL_DENIED · ACCESS_RETRY_GET · ACCESS_ACTIVATION
getPrices	service e/ou country (opcionais)	{"73":{"wa":{"cost":3.45,"count":1200}}} (menor preço, em reais)
getPricesV2	service, country	{"br":{"wa":{"3.45":1200,"4.90":80}}} (todas as faixas)
getCountries	—	países com id, nome e ISO
getServicesList	—	{"status":"success","services":[{"code":"wa","name":"WhatsApp"}]}
getActiveActivations	—	pedidos abertos com códigos recebidos

Regras

Sem maxPrice, compramos na faixa mais barata. Com maxPrice, na faixa mais cara que couber nele (mais chance de entrega).

Número reservado por 20 minutos. Sem código nesse tempo, o valor volta ao saldo sozinho. EARLY_CANCEL_DENIED quer dizer que o fornecedor ainda não libera: o cancelamento fica agendado e é feito sozinho.

Limite: 600 chamadas por minuto por chave. Consulte o status a cada 3–5 segundos.

# exemplo (curl)
curl "https://sms.svizia.com/stubs/handler_api.php?api_key=SUA_CHAVE&action=getNumber&service=wa&country=73"
# ACCESS_NUMBER:184032:5511912345678
curl "https://sms.svizia.com/stubs/handler_api.php?api_key=SUA_CHAVE&action=getStatus&id=184032"
# STATUS_OK:948010