{
"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'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Analizador y validador de números de teléfono ClearCheck API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Devuelve la entrada original, indicadores de validez, país detectado, código de llamada, número E.164 normalizado, formatos de visualización internacional y nacional, número nacional, tipo de número, estado del prefijo móvil, errores y una exención de responsabilidad sobre la validación
`valid: true` significa que el número coincide con un código de llamada de país reconocido y las reglas aplicables del plan de numeración, como la longitud esperada. No confirma que el número esté asignado, activo o sea accesible.
`possible_length` indica si la longitud del número está permitida por el plan de numeración detectado. `valid` resume el resultado general de la validación estructural, incluidas las comprobaciones del país y del formato. Un número estructuralmente válido aún puede no pertenecer a un abonado real.
La API devuelve JSON `e164` contiene el formato internacional compacto como `+254712345678` `international` añade espacios para facilitar la lectura `national` usa el formato nacional del país y `national_number` contiene el número sin el código de llamada del país
La API admite 124 países y territorios. La cobertura incluye códigos ISO de país, nombres, códigos de llamada, longitudes esperadas de los números y prefijos móviles cuando se consideran fiables. El endpoint de cobertura proporciona las reglas disponibles para cada país. .
La respuesta puede clasificar un número mediante el campo `type`, por ejemplo, como `mobile`. La clasificación como móvil depende de los datos disponibles sobre los planes de numeración y los prefijos. Una clasificación ausente o incierta no debe considerarse una prueba de que el número sea fijo, móvil o esté asignado.
Los números pueden proporcionarse en notación internacional, incluidos formatos con espacios, como `+254 712 345 678` La API normaliza las entradas reconocidas al formato E.164 y proporciona formatos de visualización internacional y nacional Usa los endpoints de normalización cuando solo se necesite el resultado en formato E.164
Los endpoints de normalización devuelven HTTP 422 cuando el número proporcionado no puede normalizarse estructuralmente. Las respuestas de error usan JSON con el formato `{"error":{"code","message"}}`. Las aplicaciones deben inspeccionar el código de estado y los campos de error en lugar de asumir que se generó un valor E.164.