Utilisation de plusieurs aperçus
Lorsqu'ils utilisent l'API Identity Insights, les utilisateurs peuvent récupérer n'importe quelle combinaison de différents ensembles de données, connus sous le nom d'insights, en un seul appel d'API.
L'API Identity Insights est disponible via plusieurs points de terminaison régionaux. Les exemples de ce guide utilisent le point de terminaison de l'UE, mais vous pouvez en trouver la liste complète à l'adresse suivante Détails techniques.
Par exemple, cette requête cURL renverra les aperçus de SIM Swap et de Subscriber Match :
curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "3932462384260",
"purpose": "FraudPreventionAndDetection",
"insights": {
"sim_swap": {
"period": 240
},
"subscriber_match": {
"id_document": "66666666q",
"name": "Federica Sanchez Arjona",
"given_name": "Federica",
"family_name": "Sanchez Arjona",
"address": "101 Crawfords Corner Road Ste 2416",
"street_name": "Crawfords Corner Road",
"street_number": "101",
"postal_code": "07733",
"country": "US",
"house_number_extension": "Suite 2416",
"birthdate": "1978-08-22",
}
}
}'
La réponse contiendra alors les résultats des deux demandes insight dans le fichier insights objet :
{
"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"
}
}
}
}
De même, cet appel API renverra les informations relatives au format, au transporteur actuel et à la vérification de l'emplacement :
curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "3932462384260",
"purpose": "FraudPreventionAndDetection",
"insights": {
"format": {},
"current_carrier": {},
"location_verification": {
"location": {
"type": "CIRCLE",
"radius": 3000,
"center": {
"latitude": -90,
"longitude": -180
}
}
}
}
}'
La réponse contiendra alors les résultats de toutes les intuitions de la rubrique insights objet :
{
"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"
}
}
}
}