A resposta curta: há dois caminhos. No primeiro, o seu sistema gera o código, guarda-o com hash, conta as tentativas e manda-nos só o texto pronto, com POST /v1/sms/messages. No segundo, usa a nossa API de verificação, POST /v1/sms/otp, e nós fazemos tudo isso por si. Para confirmar números, entradas e pagamentos, o segundo é mais simples e mais difícil de fazer mal. O primeiro serve quando precisa de algo que a API de verificação não faz.
Lado a lado
|
Códigos próprios (/v1/sms/messages) |
API de verificação (/v1/sms/otp) |
| Quem gera o código |
O seu sistema |
Nós, com um código aleatório |
| Onde fica guardado |
Na sua base de dados (deve ser só o hash) |
Conosco, só o hash; o seu sistema guarda o id |
| Validade e tentativas |
Tem de as programar |
Campos expires_in e max_attempts, com omissões |
| Formato do código |
O que quiser |
Só algarismos, de 4 a 8 |
| Texto |
Livre, até 1.600 caracteres |
O seu, até 300 caracteres, com {code} uma vez |
| Ordem de saída |
Na fila normal da conta |
À frente dos outros envios da conta |
| Testes na Sandbox |
Simula o envio |
Simula o envio e devolve o código, para testar a conferência |
| Custo |
Os créditos do SMS |
Os créditos do SMS; a conferência não gasta nada |
Quando escolher a API de verificação
| 1 |
Confirmar que o número é do cliente, no registro ou quando ele muda de número.
|
|
| 2 |
Pôr um segundo passo na entrada do seu site ou aplicação, sem obrigar a instalar nada.
|
|
| 3 |
Aprovar uma operação: um pagamento, um levantamento, uma entrega. Um código por operação, com validade curta.
|
|
| 4 |
Quando não quer ter códigos na sua base de dados. Menos dados guardados, menos dados a perder.
|
|
Quando os códigos próprios fazem sentido
Se o código tiver de ter letras, se tiver de valer mais do que 60 minutos (já não é bem um código de verificação, é uma senha temporária), ou se o seu sistema já tiver toda a lógica feita e testada, pode continuar enviando o texto pronto pela API de SMS. Nesse caso, os cuidados de segurança são todos seus: estão em enviar códigos de uso único com segurança, e a parte prática em códigos de verificação pela API de SMS.
|
Não misture os dois caminhos para a mesma coisa. Um código gerado por si e enviado como mensagem normal não pode ser conferido com /verify: a API de verificação só conhece os códigos que ela própria gerou.
|
|
A mesma chave serve aos dois. Enviar uma mensagem e enviar ou conferir um código de verificação pedem a mesma permissão, sms:write. Ver o estado pede sms:read.
|
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde R$ 36,30/mês (plano de 3 anos, com cupom) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
