API de análisis de tru.ID

¿Qué es la Analytics API?

En API de análisis es una nueva función lanzada por tru.ID. Esta función se ha creado para permitir a aquellos con acceso al espacio de trabajo de tru.ID exportar datos de análisis e informes directamente.

‍

Las API de tru.ID confirman la titularidad de un número de teléfono móvil verificando la posesión de una tarjeta SIM activa con el mismo número, funcionando como prueba de posesión para la autenticación multifactor (AMF).

‍

La nueva Analytics API proporciona principalmente datos para determinar el porcentaje de controles correctos y fallidos.

¿Dónde puedo ver la API en acción?

La Analytics API se ha implementado en su Consola para desarrolladores para facilitar el acceso si no desea hacer uso de la propia API. Sin embargo, toda la funcionalidad que se muestra en la consola de desarrollador y más está disponible para usted con la API.

‍

A continuación se muestra un ejemplo de la API Analytics integrada en su Consola para desarrolladores. Esto permite a los que tienen acceso al espacio de trabajo ver estadísticas sobre la Producto de su elección (PhoneCheck, SubscriberCheck o SIMCheck), con el diseño de su elección (por hora, por día o por mes), y sobre el tiempo periodo de su elección.

‍

‍

Debajo del gráfico de análisis en la consola de desarrollador, encontrará una tabla con un poco más de información sobre el desglose de las estadísticas de PhoneCheck. Está agrupada por proyecto y muestra uno de los cuatro resultados posibles para cada proyecto:

‍

• COMPLETADO (El número de teléfono coincide)
• COMPLETADO (El número de teléfono no coincide)
• EXPIRADO (La URL de comprobación única se activó pero nunca se completó)
• ERROR (Puede deberse a que el operador de red móvil (ORM) no es compatible o a que el dispositivo no tiene una dirección IP móvil).

‍

‍

¿Cómo puedo utilizar la API?

La API Analytics se encuentra en la sección Especificaciones API dentro del tru.ID Portal de documentación para desarrolladores.

‍

Existen tres puntos finales distintos para esta API. Cada uno de ellos dispone de los mismos parámetros. La última parte de la URL del punto final especifica cuál desea utilizar:

‍

• Por hora (`/hora`)
• Diario (`/diario`)
• Mensual (`/mes)`)

En la siguiente URL se muestra un ejemplo de solicitud de Analytics. Esto comprueba si hay Analytics mensual en PhoneCheck (`pck`), donde `match` es verdadero, y los resultados se agrupan por `project_id`.

‍

‍

Acceso a Analytics API a través de CLI

También se puede acceder a la API de análisis desde la interfaz de línea de comandos de IDlayr. El resumen detallado se puede encontrar en la sección Referencia de la interfaz de línea de comandos (CLI) dentro del IDlayr Portal de documentación para desarrolladores.

‍

Al igual que en la API, para acceder a los datos analíticos hay que especificar dos parámetros (un producto y un intervalo de tiempo) después de "analytics":` prefijo del comando:

donde

• PRODUCTO = `pck | sck |suk`
• TIME-BUCKET = `horario | diario | mensual`

‍

Un ejemplo de acceso a las analíticas desde el CLI de IDlayr se muestra en el siguiente comando. Esto comprueba las analíticas mensuales en PhoneCheck (`pck`), donde `match` es verdadero, y los resultados se agrupan por `project_id`.

‍

‍

Esto es todo lo que necesita saber para empezar a utilizar la API de Analytics y comenzar a analizar sus datos de tru.ID de forma eficaz.

‍

Si tiene alguna pregunta, no dude en ponerse en contacto con [email protected] o participa en nuestro grupo Slack específico.