Detalle de la API

A continuación podrá consultar la información, comercial, técnica y funcional de la API seleccionada.

Validate_Phone_GOLD

Validation and standardization Phone Gold

Proveedor: Sysworld

Fecha: 2019-05-23 11:38:42


developers, fintech, notifications, productivity, security, utilities

automotive, coorp, fintech, gov, insurance, pymes, retail, tech
$ Info
       
  • ID : 81f08cf0ac9eb029f7e7722f0cd6af2e
  • Contexto : validations/phone/validate_gold
  • Estado : Activa

La herramienta de Validación de teléfonos es la solución informática para validar y normalizar números de teléfonos ya sean fijos o móviles, nacionales o internacionales de forma simple y segura.

Años de trayectoria brindando soluciones al mundo empresarial y financiero, nos han permitido detectar la gran cantidad de teléfonos erróneos y sin normalizar que perjudican la comunicación con el destinatario. Destinos imposibles de contactar y dañinos que pueden provocar bloqueos y la  introducción en listas negras por los proveedores de comunicaciones.

Muchos de estos teléfonos son recolectados de diferentes canales, para incluirlos en comunicaciones o acciones electrónicas comerciales, si el número falla entonces la comunicación con el destinatario fallará también.

Etapas de la Validación:

  • Validación de sintaxis del Teléfono: Se validan la cantidad de dígitos, se asigna país de defecto y área predeterminada.
  • Normalización del número: Se estandariza el número de teléfono separando País, Área, Número.
  • Se consulta línea asignada mediante datos oficiales ENACOM.
  • Mediante interconexión con prestadoras de telefonía se solicita información de:
    • Estado del teléfono.
    • Tipo de Teléfono: Móvil / Fijo.
    • Roaming Activado: SI / NO.
    • Compañía Prestadora.
  • Se asigna Descripción de Área Geográfica.
  • Se consulta Titular de la línea (Opcional).
  • Se consulta Teléfono en Registro NO LLAME.

Información adicional de valor agregado:

Gracias a nuestra alianza estratégica con Buro de Datos se podrían enriquecer datos de valor agregado:

  • Titular de la línea
  • DNI / CUIT / CUIL
    • Datos de valor agregado con servicio de validación y normalización de identidad.

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

  • Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/validations/phone/validate_gold

Parámetros:

  • token-susc: Token obtenido al momento de la suscripción a nivel empresa.
  • token-api: Token obtenido al momento de la suscripción a nivel API.
  • phone: Número de teléfono a validar (solo números).
  • country: Código ISO del país (ie: AR para Argentina).
  • internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.

La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/validations/phone/validate_gold?token-susc=TOKENSUSC&token-api=TOKENAPI&phone=01111111111&country=AR&internalid=41

Una vez realizada la llamada van a recibir los siguientes parámetros:

  • state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
  • desc: Descripción del parámetro "state" recibido.
  • phonenumber: Incluye código de país, número nacional y fuente de código de país
  • validnumber: Indica si un número es válido (1) o no.
  • validnumberforregion: Indica si un número es válido o no en una región.
  • possiblenumber: Número posible.
  • isPossiblenumberwithreason: Número posible con motivo.
  • phonenumberregion: Región del número de teléfono.
  • phonenumertype: Indica si es un teléfono móvil o no.
  • phoneformate164: Número de teléfono único internacional según formato E.164.
  • phoneformatnational: Formato de teléfono nacional.
  • phoneformatinternational: Formato internacional del número de teléfono.
  • geolocation: Indica la ubicación geográfica del teléfono.
  • iswhatsappnumber
  • result: es el resultado de la validación, devuelve más datos (los que menciona abajo).
    • id:
    • msisdncountrycode: Número de directorio de abonado internacional de la estación móvil Código de país.
    • msisdn: Número de directorio de abonados internacional de la estación móvil.
    • statuscode
    • hlrerrorcodeid
    • subscriberstatus: Estado de suscriptor.
    • imsi
    • mccmnc
    • mcc
    • mnc
    • msin
    • servingmsc
    • servinghlr
    • originalnetworkname: Nombre de la red de origen.
    • originalcountryname: Nombre del país de origen.
    • originalcountrycode: Código del país de origen.
    • originalcountryprefix: Prefijo del país de origen.
    • originalnetworkprefix: Prefijo de red de origen.
    • roamingnetworkname: Describe el nombre de la red de roaming.
    • roamingcountryname: Nombre del país en itinerancia.
    • roamingcountrycode: Código de país de itinerancia.
    • roamingcountryprefix: Prefijo de país de itinerancia.
    • roamingnetworkprefix: Prefijo de red de itinerancia.
    • portednetworkname: Nombre de la red portada.
    • portedcountryname: Nombre del país transferido.
    • portedcountrycode: Código de país portado.
    • portedcountryprefix: Prefijo de país transferido.
    • portednetworkprefix: Prefijo de red portado.
    • isvalid: Indica si un número es válido (1) o no.
    • isported: Indica si es un número transferido.
    • isroaming: Indica si es un número de roaming
    • usercharge
    • inserttime
    • storage
    • route
    • interface:
  • id_internal: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"invalid country.","id_internal":"0"}

Positiva:

{"state":"1","phonenumber":"Country Code: 54 National Number: 1132624495 Country Code Source: 3","validnumber":"1","validnumberforregion":"1","possiblenumber":"1","isPossiblenumberwithreason":"0","phonenumberregion":"AR","phonenumertype":"mobile","phoneformate164":"+541132624495","phoneformatnational":"011 3262-4495","phoneformatinternational":"+54 11 3262-4495","geolocation":"Buenos Aires","iswhatsappnumber":"missing_susc","result":[{"id":"52015ffc320c","msisdncountrycode":"AR","msisdn":"+541132624495","statuscode":"HLRSTATUS_DELIVERED","hlrerrorcodeid":null,"subscriberstatus":"SUBSCRIBERSTATUS_CONNECTED","imsi":"7223100000","mccmnc":"722310","mcc":"722","mnc":"310","msin":null,"servingmsc":null,"servinghlr":null,"originalnetworkname":"Claro Argentina (AMX Argentina S.A.)","originalcountryname":"Argentina","originalcountrycode":"AR","originalcountryprefix":"+54","originalnetworkprefix":"113262","roamingnetworkname":null,"roamingcountryname":null,"roamingcountrycode":null,"roamingcountryprefix":null,"roamingnetworkprefix":null,"portednetworkname":null,"portedcountryname":null,"portedcountrycode":null,"portedcountryprefix":null,"portednetworkprefix":null,"isvalid":"Yes","isported":"No","isroaming":"No","usercharge":"0.01000","inserttime":"2021-04-27 10:28:12.990-0300","storage":"CURL_API","route":"IP1","interface":"Sync API"}]}

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test



Definición Técnica de la API:

  • Crear una
    Cuenta Gratis

  • Probar las APIS
    sin créditos

  • Aprobar la
    suscripción y pagar