Validacao CPF
Valida um numero de CPF verificando formato e digitos verificadores pelo algoritmo Modulo 11.
Endpoint
POST /api/v2/external/cpf/validateHeaders
| Header | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
Authorization | String | Sim | Bearer {access_token} |
Content-Type | String | Sim | application/json |
Request Body
| Campo | Tipo | Obrigatorio | Descricao | Exemplo |
|---|---|---|---|---|
document_number | String | Sim | Numero do CPF (com ou sem formatacao) | "12345678909" ou "123.456.789-09" |
Exemplo
bash
curl -X POST https://api.owem.com.br/api/v2/external/cpf/validate \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"document_number":"12345678909"}'Resposta de Sucesso -- CPF Valido (200)
json
{
"worked": true,
"valid": true,
"formatted": "123.456.789-09"
}Resposta de Sucesso -- CPF Invalido (200)
json
{
"worked": true,
"valid": false,
"formatted": null
}| Campo | Tipo | Descricao |
|---|---|---|
worked | Boolean | true indica que a requisicao foi processada |
valid | Boolean | true se o CPF e valido, false caso contrario |
formatted | String | CPF formatado (XXX.XXX.XXX-XX) se valido, null se invalido |
Validacoes Realizadas
- Verifica se o CPF possui exatamente 11 digitos
- Rejeita CPFs com todos os digitos iguais (ex:
111.111.111-11) - Calcula e verifica os 2 digitos verificadores pelo algoritmo Modulo 11
Resposta de Erro (400)
json
{
"worked": false,
"detail": "O campo document_number e obrigatorio"
}Resposta de Erro (401)
json
{
"worked": false,
"detail": "Token invalido ou expirado"
}Uso
Este endpoint realiza apenas validacao matematica do CPF (Modulo 11). Nao consulta a Receita Federal nem verifica a situacao cadastral do documento.