> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificação de Telefone por SMS: API e Sinais de Risco

> Didit: OTP por SMS em dois passos, com deteção de operadora e números virtuais ou descartáveis. Preço da operadora + $0.02, sem contratos.

A API de Verificação de telefone fornece um fluxo de dois passos: envia um código de utilização única para um número de telefone e, depois, verifica o código. O sistema deteta o tipo de operadora, os números virtuais e os telefones descartáveis.

## Endpoints

> [card] [Enviar código de telefone](https://docs.didit.me/pt/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`: envia um código de verificação de utilização única por SMS.

> [card] [Verificar código de telefone](https://docs.didit.me/pt/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`: verifica o código e obtém os dados de risco do telefone.

> [card] [Calcular pontuação de risco do telefone](https://docs.didit.me/pt/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/`: calcula o risco da operadora, do tipo de linha, da portabilidade e de fraude, sem enviar um OTP.

## Como funciona

1. Chame **Enviar código de telefone** com o número de telefone no formato E.164 (por exemplo, `+14155552671`)
2. O utilizador recebe um código por SMS (válido durante 5 minutos)
3. Chame **Verificar código de telefone** com o número de telefone e o código
4. 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:

| Canal | Descrição |
| - | - |
| SMS | Mensagem de texto normal |
| WhatsApp | Mensagens do WhatsApp |
| Telegram | Mensagens do Telegram |
| RCS | Rich Communication Services |
| Viber | Mensagens do Viber |

## Sinais de risco

| Sinal | Descrição |
| - | - |
| `is_disposable` | Número de telefone temporário ou descartável |
| `is_virtual` | Número VoIP ou virtual |
| `carrier.type` | `mobile`, `landline` ou `voip` |

Para a estrutura completa da resposta, consulte o [Relatório de verificação de telefone](https://docs.didit.me/pt/core-technology/phone-verification/overview.md).

## 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 devolvem `502` 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.