Verificación de la ubicación [Developer Preview]

La herramienta de verificación de la ubicación le permite verificar la ubicación de un dispositivo de usuario final dentro de un área especificada. Utiliza técnicas de posicionamiento de redes celulares para localizar el dispositivo, lo que proporciona varias ventajas sobre el posicionamiento GPS, entre ellas:

• Seguro y de confianza: La localización mediante redes móviles utiliza información procedente directamente de las redes de los operadores de telefonía móvil, lo que elimina el riesgo de falsificación de la señal GPS y de elusión a través de una VPN.
• Integración simplificada: Identity Insights se puede integrar fácilmente en tus aplicaciones, lo que reduce la complejidad y el esfuerzo que supone el desarrollo de software.

Algunos casos de uso de la prevención del fraude en los que resulta útil la verificación de la ubicación:

• Verificación de usuarios en el comercio electrónico: Las plataformas de comercio electrónico y de contenidos se enfrentan al reto de que los usuarios consuman servicios, contenidos y licencias fuera de la región para la que se les ha concedido la licencia. La función Verify de ubicación permite a estas plataformas comprobar si la ubicación de un usuario final se encuentra dentro de la región autorizada para el servicio, el contenido o la licencia.
• Verificación en el punto de venta: Cuando un usuario realiza una compra en una tienda utilizando su tarjeta de crédito o débito, en ocasiones su entidad financiera querrá verificar si dicha transacción es fraudulenta. La verificación de la ubicación podría utilizarse junto con el número de teléfono introducido en su aplicación bancaria para consultar el lugar desde donde se inició la transacción, con el fin de confirmar que el usuario se encuentra en ese lugar.
• Contenidos basados en la localización: Verify la ubicación de un usuario durante eventos deportivos o conciertos para mejorar su experiencia con contenido personalizado, como repeticiones de goles, diferentes ángulos, información útil y mucho más.

Requisitos previos

Para utilizar Identity Insights, debe asegurarse de que su Account está configurado correctamente; consulte la sección Primeros pasos para obtener más información:

• Crear tu Account,
• Creación de una aplicación de Vonage para su uso con la API Identity Insights,
• Los distintos entornos disponibles y cómo configurar tu Account para utilizarlos,
• Y cómo utilizar la interfaz de usuario «Primeros pasos» del panel de control para utilizar la API sin tener que escribir código.

Esta guía explicará cómo utilizar el programa Location Verification Insight utilizando cURL.

Realizar una llamada a la API

La autenticación para la API Identity Insights se realiza mediante JWT, un token JSON compacto y autocontenido. Para generar un JWT, puede utilizar nuestra herramienta generador en línea, o bien utiliza el CLI de Vonage. Necesitará su ID de aplicación y su clave privada para generar el JWT. Una vez que tenga su JWT, puede enviar una solicitud a la API.

Este ejemplo muestra una solicitud cURL para la métrica «Verificación de ubicación», con el fin de comprobar si la ubicación de un dispositivo de usuario concreto se encuentra dentro del área especificada:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "location_verification": {
         "location": {
            "type": "CIRCLE",
            "radius": 3000,
            "center": {
               "latitude": -90,
               "longitude": -180
                }
            }
          }
        }
    }'

A continuación, la API comparará la zona facilitada como dato de entrada para ese usuario de teléfono móvil concreto con la ubicación disponible en los propios sistemas del operador de dicho usuario, y devolverá una confirmación en caso de que coincidan:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "location_verification": {
        "is_verified": "TRUE",
        "latest_location_at": "2024-07-08T09:30:27.504Z",
        "match_rate": 1,
        "status": {
          "code": "OK",
          "message": "Success"
        }
    }
  }
}

Aquí, el status indica el estado de la información devuelta para el número de teléfono especificado:

Si status.code en la respuesta se indica que OK, también es posible que aparezcan los campos descritos en la tabla siguiente. Si un campo aparece marcado como «Sí» en la columna «Obligatorio», siempre se mostrará cuando el estado sea «OK». Si un campo aparece marcado como «No», puede que se muestre o puede que no.

Lecturas complementarias

• Para obtener más información sobre la API de Identity Insights, consulta la Referencia API.
• Si tiene alguna pregunta, puede ponerse en contacto con nosotros en el Comunidad de Vonage Slack.