Endpoints
Enviar código de telefone
POST /v3/phone/send/: envia um código de verificação de utilização única por SMS.Verificar código de telefone
POST /v3/phone/check/: verifica o código e obtém os dados de risco do telefone.Calcular pontuação de risco do telefone
POST /v3/phone/risk/: calcula o risco da operadora, do tipo de linha, da portabilidade e de fraude, sem enviar um OTP.Como funciona
- Chame Enviar código de telefone com o número de telefone no formato E.164 (por exemplo,
+14155552671) - O utilizador recebe um código por SMS (válido durante 5 minutos)
- Chame Verificar código de telefone com o número de telefone e o código
- Receba o resultado da verificação e os sinais de risco (tipo de operadora, deteção de número virtual)
Canais de entrega
A Didit suporta vários canais, consoante a disponibilidade no país:Sinais de risco
Para a estrutura completa da resposta, consulte o Relatório de verificação de telefone.
Falhas do fornecedor
Se o fornecedor de telefonia a montante não responder a um pedido de envio ou de verificação, ambos os endpoints devolvem502 com code: "phone_provider_unavailable", em vez de um erro genérico. Pode repetir o pedido sem risco, não é faturado e não consome uma tentativa do limite horário por número. Use code para decidir o fluxo, em vez de analisar a mensagem detail, uma vez que o texto da mensagem não é um contrato estável.