Utilizar múltiples perspectivas

Al utilizar la API Identity Insights, los usuarios pueden recuperar cualquier combinación de diferentes conjuntos de datos, conocidos como insights, en una sola llamada a la API.

La API Identity Insights está disponible a través de varios puntos finales regionales. Los ejemplos de esta guía utilizan el punto final de la UE, pero puede consultar la lista completa en Detalles técnicos.

Por ejemplo, esta solicitud cURL devolverá tanto la información de SIM Swap como la de Subscriber Match:

La respuesta contendrá entonces los resultados de ambas peticiones en el campo insights objeto:

{
   "request_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
   "insights": {
    "sim_swap": {
        "latest_sim_swap_at": "2024-07-08T09:30:27.504Z",
        "is_swapped": true,
        "status": {
          "code": "OK",
          "message": "Success"
        }
    },
  "subscriber_match": {
    "id_document_match": "EXACT",
    "name_match": "HIGH",
    "given_name_match": "DATA_UNAVAILABLE",
    "family_name_match": "DATA_UNAVAILABLE",
    "address_match": "EXACT",
    "street_name_match": "EXACT",
    "street_number_match": "EXACT",
    "postal_code_match": "EXACT",
    "country_match": "EXACT",
    "birthdate_match": "NONE",
    "status": {
        "code": "OK",
        "message": "Success"
      }
    }
  }
}

Del mismo modo, esta llamada a la API devolverá la información sobre Formato, Operador actual y Verificación de ubicación:

La respuesta contendrá entonces los resultados de todos los insights del insights objeto:

{
    "request_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
    "insights": {
        "format": {
            "country_code": "US",
            "country_name": "United States",
            "country_prefix": "1",
            "offline_location": "Georgia",
            "time_zones": [
            "America/New_York"
            ],
            "number_international": "+14040000000",
            "number_national": "(404) 000-0000",
            "is_format_valid": true,
            "status": {
              "code": "OK",
              "message": "Success"
            }
        },
        "current_carrier": {
            "name": "Orange Espana, S.A. Unipersonal",
            "network_type": "MOBILE",
            "country_code": "ES",
            "network_code": "21403",
            "status": {
              "code": "OK",
              "message": "Success"
            }
        },
        "location_verification": {
            "is_verified": "TRUE",
            "latest_location_at": "2024-07-08T09:30:27.504Z",
            "match_rate": 1,
            "status": {
              "code": "OK",
              "message": "Success"
            }
        }
    }
}