Conditions du contrat
Download File
Risk Persona
€0.70 + TVA
Le service pour vérifier rapidement les informations personnelles, le domicile, le numéro de téléphone et les événements négatifs d'une personne. De plus, le service vérifie également l'existence en vie des personnes.
Le service Risk Persona fait partie de l'API RISK et permet, à partir du paramètre code fiscal, d'obtenir une série d'informations utiles pour la vérification et l'identification d'un particulier.
Le service est identifié par l'endpoint https://risk.openapi.com/IT-richiesta.
Risk Persona permet, avec une seule demande, d'obtenir nom et prénom, résidence, négativité et téléphone.
EXEMPLE DE DEMANDE
POST /richiesta
La méthode à utiliser pour la demande est POST :
POST https://risk.openapi.com/IT-richiesta
Les paramètres à transmettre dans le body de la requête sont :
- code fiscal
- callback (optionnel)
Voici un exemple des paramètres nécessaires pour une demande avec le code fiscal DRSCLD70P15H501V :
{
"cf_piva": "DRSCLD70P15H501V",
"tipo": [
"anagrafica", "negativita","telefoni"
]
"callback": {
"url": "https://yourdomain.com/your_script",
"method": "POST",
"field": "data",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
Il est possible de demander uniquement une partie des informations. Dans ce cas, il sera possible d'indiquer dans le champ type le dataset d'informations souhaité (données personnelles, négativité ou téléphones) ou d'utiliser directement, lors de la requête, les endpoints spécifiques pour chaque dataset.
La réponse est asynchrone et il est possible de configurer, lors de la demande, un callback pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET /richiesta/{id} pour vérifier l'état. Si un callback est configuré, le champ 'headers' est obligatoire et peut être utilisé pour spécifier tous les headers que l'utilisateur souhaite voir inclus dans le callback (comme par exemple session_id).
EXEMPLE DE RÉPONSE
POST /richiesta
La réponse contiendra l'identifiant de la demande à utiliser lors d'une seconde requête pour accéder aux données souhaitées :
{
"data": {
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "DRSCLD70P15H501V",
"tipo": [
"anagrafica",
"negativita",
"telefoni"
],
"callback": true,
"url" https://yourdomain.com/your_script,
"field" data,
"method" POST,
"data": false,
"headers": {
"session_id": ""oiwejdf89453urf945jfg""
}
"esito": "null"
"timestamp": "null"
"owner": "test@openapi.com"
"soggetto": "null"
"status": "PENDING",
"date_request": "null",
"date_completion": "null",
},
"success": true,
"message": "",
"error": null
}EXEMPLE DE DEMANDE
GET /IT-richiesta/{id}
Pour obtenir les données, il sera nécessaire d'effectuer une seconde demande, comme indiqué précédemment, à un autre endpoint avec l'ID précédemment obtenu.
POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e
EXEMPLE DE RÉPONSE
GET /IT-richiesta/{id}
La réponse permettra d'accéder aux informations suivantes :
- Nom
- Prénom
- État civil
- Éventuelle date de décès
- Lieu et date de naissance
- Sexe
- Adresse de résidence
- Numéro de téléphone (fixe ou mobile)
- Présence d'événements négatifs (protestations, préjudices, procédures collectives)
{
"data": {
"status": "COMPLETED",
"date_request": "2024-03-09 17:09:42",
"date_completion": "2024-03-09 17:40:57",
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "DRSCLD70P15H501V",
"tipo": [
"anagrafica",
"negativita",
"telefoni"
],
"callback": null,
"esito": {
"codice": 200,
"info": "OK"
},
"timestamp": 1717141431,
"owner": "test@openapi.it",
"soggetto": {
"code": "DRSCLD70P15H501V",
"risultato": "OK",
"nome": CLAUDIO,
"cognome": DE ROSSI,
"deceduto": false,
"decesso_data": null,
"nascita_luogo": ROMA,
"nascita_data": 1970-01-15,
"sesso": M,
"residenza":{
"indirizzo": "VIA OSTIENSE, 22 ",
"toponimo": "VIA",
"via": "OSTIENSE",
"numero_civico": "221",
"comune": "ROMA",
"cap": "00153",
"provincia": "RM"
},
"domicilio_fiscale": null,
"denominazione": CLAUDIO DE ROSSI,
"partita_iva": null,
"sede_legale": null
"utenze":[
"061234567",
"061234568",
"333123456"
],
"negativita": {
false,
false,
false
}
}
},
"success": true,
"message": "",
"error": null
}
Le service Risk Persona est également disponible pour des recherches sur des entreprises et des professionnels indépendants.
CONDITIONS ET MODALITÉS D'UTILISATION DU SERVICE
Bien que le service soit disponible en mode automatique via API, pour des raisons réglementaires, il est soumis à une surveillance continue des LOG avec les limitations suivantes :
- le service est actif de 9h à 19h
- le service est actif uniquement les jours ouvrables
- la limitation du taux est configurée automatiquement pour chaque client en fonction des volumes annuels achetés
Les demandes effectuées en dehors des heures ou des jours ouvrables sont mises en file d'attente et traitées en priorité le premier jour ouvrable.
Le service, comme indiqué dans les conditions contractuelles, a des limites de taux quotidiennes fixées pour une gestion correcte du service.
Si vous souhaitez un service personnalisé, contactez-nous ici.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Terms and conditions
