{
"input": "+254 712 345 678",
"valid": true,
"possible_length": true,
"country": {
"iso": "KE",
"name": "Kenya",
"calling_code": "+254"
},
"e164": "+254712345678",
"international": "+254 712 345 678",
"national": "0712 345 678",
"national_number": "712345678",
"type": "mobile",
"mobile_check": "préfixes mobiles vérifiés",
"errors": [],
"disclaimer": "Validation sur indicatif et longueur du plan de numérotation ; n’atteste pas que la ligne est attribuée ou joignable."
}
curl --location --request GET 'https://zylalabs.com/api/15136/clearcheck+phone+number+parser+and+validator+api/40386/parse+a+phone+number' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Analisador e validador de números de telefone ClearCheck API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Retorna a entrada original, indicadores de validade, país detectado, código de chamada, número E.164 normalizado, formatos de exibição internacional e nacional, número nacional, tipo de número, status do prefixo móvel, erros e um aviso de isenção de responsabilidade sobre a validação.
`valid: true` significa que o número corresponde a um código de discagem internacional reconhecido e às regras aplicáveis do plano de numeração, como o comprimento esperado. Isso não confirma que o número esteja atribuído, ativo ou acessível.
`possible_length` indica se o comprimento do número é permitido pelo plano de numeração detectado. `valid` resume o resultado geral da validação estrutural, incluindo as verificações de país e formato. Um número estruturalmente válido ainda pode não pertencer a um assinante real. .
A API retorna JSON `e164` contém o formato internacional compacto como `+254712345678` `international` adiciona espaços para facilitar a leitura `national` usa o formato doméstico do país e `national_number` contém o número sem o código de chamada do país
A API oferece suporte a 124 países e territórios. A cobertura inclui códigos ISO dos países, nomes, códigos de discagem, comprimentos esperados dos números e prefixos de celular quando esses prefixos são considerados confiáveis. O endpoint de cobertura fornece as regras disponíveis para os países. .
A resposta pode classificar um número usando o campo `type`, como `mobile`. A classificação como móvel depende dos dados disponíveis sobre o plano de numeração e os prefixos. A ausência de uma classificação ou uma classificação incerta não deve ser tratada como prova de que o número é fixo, móvel ou atribuído. .
Os números podem ser fornecidos em notação internacional, inclusive em formatos com espaços, como `+254 712 345 678`. A API normaliza as entradas reconhecidas para E.164 e fornece formatos de exibição internacional e nacional. Use os endpoints de normalização quando apenas o resultado E.164 for necessário.
Os endpoints de normalização retornam HTTP 422 quando o número fornecido não pode ser normalizado estruturalmente. As respostas de erro usam JSON no formato `{"error":{"code","message"}}`. As aplicações devem verificar o código de status e os campos de erro em vez de presumir que foi produzido um valor E.164