Primeiros passos

Da chave de API à primeira chamada em poucos minutos.

1. Crie uma chave de API

Acesse Painel → Chaves de API e crie uma chave nova. Guarde em lugar seguro: ela só aparece uma vez, porque a plataforma guarda apenas o hash.

2. Consulte o saldo

cURL

curl https://altiviacloud.com.br/api/v1/balance \
  -H "Authorization: Bearer ac_live_SUA_CHAVE"

3. Liste os países disponíveis

cURL

curl https://altiviacloud.com.br/api/v1/countries

As listas de países e de serviços são públicas e não exigem chave.

4. Compre um número virtual

cURL

curl -X POST https://altiviacloud.com.br/api/v1/orders \
  -H "Authorization: Bearer ac_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "countryId": "id_do_pais",
    "serviceId": "id_do_servico"
  }'

5. Leia o SMS

cURL

curl https://altiviacloud.com.br/api/v1/orders/ID_DO_PEDIDO/sms \
  -H "Authorization: Bearer ac_live_SUA_CHAVE"

6. Feche o pedido

Recebeu o código, encerre com /finish. Nada chegou, cancele com /cancel — sem SMS, o valor volta integral para a carteira. Os detalhes estão em Pedidos.

cURL

curl -X POST https://altiviacloud.com.br/api/v1/orders/ID_DO_PEDIDO/finish \
  -H "Authorization: Bearer ac_live_SUA_CHAVE"

SDKs

Os SDKs oficiais para seis linguagens estão em preparação e ainda não foram publicados. As chamadas acima funcionam com o cliente HTTP de qualquer linguagem.