ForHosting KIT · Datos y archivos

Formatee un número de teléfono internacional por país

Los números de teléfono se guardan con facilidad como texto libre, pero presentarlos de forma uniforme resulta más complejo.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Este formateador recibe un número y un código de país de dos letras, elimina la puntuación habitual, comprueba el prefijo internacional cuando se proporciona y valida la cantidad exacta de dígitos nacionales. Después devuelve una presentación internacional legible y una versión E.164 compacta. Las longitudes incorrectas y los prefijos incompatibles generan un error explícito en vez de un resultado verosímil pero poco fiable.

Indique el número y el país al que pertenece

Introduzca el número de teléfono tal como lo tenga y seleccione su código de país de dos letras. La entrada nacional puede incluir separadores habituales, como espacios, paréntesis, puntos o guiones. También puede enviar un número internacional que empiece por el signo más o utilizar el prefijo internacional 00. Cuando aparece un prefijo internacional, el formateador verifica que su código de llamada corresponda al país seleccionado. Esta comprobación es importante porque una misma secuencia de dígitos nacionales puede parecer válida en más de un lugar. Por ello, el país funciona como una instrucción explícita y no como una suposición deducida de los dígitos. En los países que emplean un cero troncal nacional, la entrada puede conservarlo; se elimina cuando la notación internacional así lo exige. El resultado incluye el código ISO normalizado, el prefijo de llamada, el número nacional significativo, el valor E.164 compacto y una versión espaciada para mostrar. Así puede utilizar la respuesta tanto en interfaces como en almacenamiento normalizado o comparaciones posteriores.

Comprenda qué garantiza la validación

Esta herramienta realiza una validación estructural para los países disponibles en el selector. Comprueba los caracteres permitidos, la relación entre un prefijo explícito y el país elegido, y la cantidad esperada de dígitos nacionales. Si existe una discrepancia, devuelve un error que indica el país, la cantidad esperada y la recibida. El comportamiento es deliberadamente estricto: añadir, recortar o inventar dígitos en silencio podría crear un número que no pertenece a nadie. La validez estructural no demuestra que una línea esté asignada, activa o accesible, que sea móvil ni que pertenezca a una persona concreta. Tampoco consulta a un operador ni envía un mensaje de verificación. El formateador trabaja únicamente con el texto proporcionado y una tabla fija de reglas nacionales. Al no realizar consultas de red, una misma entrada produce siempre la misma respuesta y el número no se comparte con ningún directorio. Considere la salida una representación fiable de una estructura conforme, no una prueba de existencia del abonado ni de su consentimiento para recibir comunicaciones.

Utilice correctamente las dos formas normalizadas

El campo formateado está pensado para mostrarse: comienza con el prefijo internacional precedido por el signo más y separa los dígitos nacionales en grupos habituales para cada país. El campo E.164 elimina esos espacios y resulta más apropiado para bases de datos, comparaciones de igualdad, cargas de API y enlaces que requieren un valor internacional compacto. Guarde el código de país junto al número normalizado cuando su aplicación necesite conservar el contexto declarado por la persona usuaria. Si acepta teléfonos mediante un formulario, valídelos antes de guardarlos para que cualquier error de longitud pueda corregirse mientras la fuente sigue disponible. En importaciones, conserve la celda original en una columna de auditoría y escriba el resultado normalizado en otra; así la limpieza no elimina pruebas sobre la entrada. Trate siempre los teléfonos como texto, nunca como valores numéricos, para preservar los ceros iniciales. Por último, recuerde que dar formato no concede permiso: aplique sus reglas habituales de consentimiento, privacidad y mensajería antes de llamar o escribir a cualquier número devuelto.

Normalizar números introducidos por clientes

Rechace de inmediato cantidades de dígitos incorrectas y guarde una representación internacional uniforme.

Depurar una importación de contactos

Convierta puntuación y notación nacional variadas en campos estables de visualización y E.164.

Preparar números para otra API

Obtenga un valor internacional compacto y conserve una versión agrupada legible para revisarla.

¿Cuánto cuesta una solicitud a la API?

Cada solicitud cuesta $0.002. La versión para navegador puede ejecutarse localmente en esta página.

¿Un resultado válido significa que el número está activo?

No. Confirma la estructura y cantidad de dígitos del país admitido, pero no su asignación, accesibilidad, titularidad ni consentimiento.

¿Puedo incluir espacios o signos de puntuación?

Sí. Se ignoran espacios, paréntesis, puntos y guiones. El signo más solo se admite al principio.

¿Puedo enviar un número internacional?

Sí. Utilice un signo más inicial o el prefijo 00. El código de llamada debe coincidir con el país seleccionado.

¿Por qué se ha eliminado el cero nacional inicial?

Algunos países usan un cero troncal solo para llamadas nacionales. La notación internacional lo omite y el valor normalizado respeta esa convención.

¿Por qué no aparece mi país?

La capacidad solo ofrece países con una regla explícita y probada. Para planes no admitidos devuelve un error en vez de hacer suposiciones.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/data/phone-number-format

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/data/phone-number-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"(202) 555-0147","country_code":"US"}'
{
  "phone_number": "(202) 555-0147",
  "country_code": "US"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.phone_number_format",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb25
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →