Começar
O teu primeiro pedido SMS
Começa na Sandbox. Entende a resposta antes de enviar uma mensagem real.
1. Prepara uma chave de teste
Cria uma chave kamba_test_ na Sandbox. Guarda-a no servidor ou terminal local como KAMBA_TEST_KEY. Não uses uma chave live neste exemplo nem no código do navegador.
Abrir Sandbox →2. Faz um pedido simulado
Define KAMBA_IDEMPOTENCY_KEY com um valor único para esta operação. Mantém o valor e o corpo se repetires o pedido. O número abaixo é fictício; uma chave de teste não envia SMS reais.
curl --request POST 'https://api.kambasms.ao/messages/send' \
--max-time 10 --fail-with-body \
--header "X-API-Key: ${KAMBA_TEST_KEY:?Set KAMBA_TEST_KEY}" \
--header "Idempotency-Key: ${KAMBA_IDEMPOTENCY_KEY:?Set KAMBA_IDEMPOTENCY_KEY}" \
--header 'Content-Type: application/json' \
--data '{"to":"+244900000000","text":"O seu pedido foi recebido."}'3. Lê a resposta
Confere o estado HTTP e o corpo da resposta. Guarda o identificador da mensagem e X-Request-Id. Um pedido aceite não comprova entrega; a Sandbox simula os resultados.
Campos do pedido e resposta esperada →Passar para produção
Usa Sender ID aprovado, créditos SMS disponíveis e uma chave live guardada no servidor. Substitui o número fictício por um destino que controlas. Envios live são pagos; não repitas um envio incerto com uma nova chave de idempotência.
Se o pedido falhar →