API de WhatsApp y CRM
POST/validate/number

Validar números (alias de Validate)

Alias de Numbers/Validate(operation/validateNumbers), agrupado bajo /validate para que la validación de números y de nombres de usuario se vea como una sola familia.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.ai/v1/validate/number

Alias de [Numbers/Validate](#operation/validateNumbers), agrupado bajo /validate para que la validación de números y de nombres de usuario se vea como una sola familia.

Mismo controlador, misma estructura de respuesta: consulta ese endpoint para ver la documentación completa.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

CampoTipoObligatorioDescripción
countrystringNoCódigo de país opcional de los números de la lista. Ej.: US, GB, IT, FR, DE. No cambia la forma en que se leen los números: para que los escritos sin + se lean como números de un país, envía su prefijo telefónico internacional como prefix. minLength: 2 · maxLength: 2
prefixnumberNoPrefijo telefónico internacional opcional, como valor numérico, que se antepone a cada número de la lista que no empiece por +. Ej.: 1, 2, 33, 44, 36... minimum: 1 · maximum: 9999 · format: float
numbersarray<object>SíLista de números de teléfono que se van a validar y normalizar. Debes proporcionar al menos un elemento.

Respuestas

CódigoDescripción
200Resultados de la validación
400Solicitud incorrecta
401No autorizado
403Faltan los permisos necesarios
404Recurso no encontrado
409Conflicto
429Demasiadas solicitudes
500Error inesperado
501No implementado
503Servicio no disponible
// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Validates and normalizes a list of phone numbers, reading the ones without + as US numbers
curl --request POST \
  --url https://api.getincloud.ai/v1/validate/number \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"prefix":1,"numbers":[{"phone":"415-555-0142"},{"phone":"+1 415 555 0142"}]}'
AnteriorValidar númerosSiguienteActualizar webhook
¿Te sirvió esta página?