Kamba Verify

Já tens uma chave? Personaliza os exemplos temporariamente

Opcional. A chave ficará visível nos exemplos de código. Fica apenas na memória desta página: sem guardar nem enviar. Limpa-a antes de partilhar o ecrã ou capturas.

Os exemplos usam valores ilustrativos. Para enviar, cria uma conta e uma chave API e aguarda a aprovação do Sender ID.

$ Gerar Chave

Verificação

Kamba Verify

Fluxo completo de verificação em duas chamadas. A API gera, envia, limita, expira e confirma o código.

POST/verify/start

Inicia a verificação e envia o código. Debita 1 crédito por segmento SMS em produção.

phonestringobrigatório

Número no formato +244XXXXXXXXX

sender_idstringopcional

Usa o Sender ID associado à chave quando omitido

curl -X POST https://api.kambasms.ao/verify/start \
  -H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"phone":"+244912345678"}'

POST/verify/check

Confirma o código introduzido pelo utilizador.

verification_iduuidobrigatório

Identificador devolvido por /verify/start

codestringobrigatório

Código de 6 dígitos

curl -X POST https://api.kambasms.ao/verify/check \
  -H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"verification_id":"UUID","code":"123456"}'

Verify exige a mesma conta e ambiente. O reenvio exige remetente aprovado/ativo, intervalo de 60 segundos e permite duas tentativas. Reservar o reenvio invalida o código live anterior; durante envio ou reconciliação, confirmações/reenvios devolvem 409. Um resultado 202 incerto exige reconciliação antes de outro envio. O histórico oculta o código. Uma sessão já verificada pode voltar a devolver sucesso; usa Authenticator para provas de login consumíveis.Gestão: POST /verify/resend, GET /verify, GET /verify/stats?days=30, GET /verify/events e GET /verify/:id.