A resposta curta: com uma chave sandbox_, a API valida cada pedido e responde como em Produção, mas nenhum SMS sai e nada se cobra: o estado vem simulated e a resposta traz o cabeçalho X-API-Simulated: true. É o sítio certo para provar, um a um, os casos que vão acontecer no dia a dia, incluindo os errados.
Os casos a testar
| Caso |
O que enviar |
O que deve voltar |
| Envio normal |
Um número válido e um texto curto |
201, estado simulated, com parts e encoding |
| Número errado |
Por exemplo 12 |
422, invalid_number |
| Sem texto |
O campo text vazio |
422, text_required |
| Texto demasiado longo |
Mais de 1.600 caracteres |
422, text_too_long |
| Texto com acentos |
O mesmo aviso com «ã» ou «ç» |
Mais parts e outro encoding: confirme o custo |
| Remetente por aprovar |
Um sender que não está aprovado |
422, sender_not_approved |
| Repetição igual |
O mesmo pedido, com a mesma Idempotency-Key |
A mesma resposta, com Idempotent-Replayed: true |
| Mesma chave, outro texto |
A mesma Idempotency-Key com outro corpo |
409, idempotency_conflict |
| Agendado no passado |
send_at com uma data que já passou |
422, send_at_in_past |
| Chave sem permissão |
Uma chave sem sms:write |
403, insufficient_scope |
Cada caso deve dar, no seu sistema, a reacção certa: guardar o id, não repetir um 422, avisar a equipa. Se o sistema reage mal na Sandbox, reage mal em Produção.
Para o teste não ir parar a Produção
| 1 |
Envie o cabeçalho X-API-Mode: sandbox nos testes. Se a chave não for de Sandbox, a API recusa com mode_mismatch em vez de enviar.
|
|
| 2 |
Confirme o modo da chave com GET /v1/token: o campo mode diz sandbox ou production.
|
|
| 3 |
Guarde as duas chaves em sítios diferentes (configuração de testes e de produção), nunca no código.
|
|
|
O que a Sandbox não mostra: como a mensagem fica no telemóvel. Antes de abrir aos clientes, faça um envio real em Produção para o seu próprio número e veja o remetente, as partes e o texto. E lembre-se: a chave sandbox_ lê dados verdadeiros da conta, como o saldo, por isso guarda-se com o mesmo cuidado.
|
Passar para Produção
Crie uma chave prod_ com as permissões mínimas no API Center do My MozOut e troque-a na configuração: o pedido é igual, só muda o prefixo. Se GET /v1/token mostrar writes_simulated a true, a API ainda está em preparação e os envios continuam simulados. Os primeiros dias pedem atenção ao histórico e às estatísticas.
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde $6.60/mês (plano de 3 anos, com cupão) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
