€0.70 + TVA
Toutes les informations pour identifier une entreprise, telles que le nom, l'adresse légale, les données ATECO, le numéro de téléphone et les événements négatifs.
Le service Risk Libero Professionista fait partie de l'API RISK et permet d'obtenir, à partir du paramètre numéro fiscal, une série d'informations utiles pour identifier la résidence, le domicile fiscal et le numéro de téléphone, ainsi que pour vérifier d'éventuels événements négatifs concernant un professionnel.
Le service est identifié par l'endpoint https://risk.openapi.com/IT-richiesta.
Risk Libero Professionista permet, avec une seule demande, d'obtenir la dénomination, le siège social, le code et la description ATECO, les négativités et le numéro de téléphone.
POST/IT-richiesta
La méthode à utiliser pour la demande est POST :
POST https://risk.openapi.com/IT-richiesta
Les paramètres à passer dans le corps de la requête sont :
Ceci est un exemple des paramètres à utiliser pour une demande avec le numéro fiscal RSSMRA90D15L117D :
{
"cf_piva": "RSSCLD79R07H501O",
"tipo": [
"anagrafica", "negativita","telefoni"
]
"callback": {
"url": "https://yourdomain.com/your_script",
"method": "POST",
"field": "data",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
Il est possible de demander également seulement une partie des informations. Dans ce cas, il sera possible d'indiquer dans le champ type le dataset d'informations souhaité (anagrafica, negatività ou telefoni) ou d'utiliser directement les endpoints spécifiques pour chaque dataset lors de la demande.
La réponse est asynchrone et il est possible de définir, lors de la demande, un callback pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET/IT-richiesta/{id} pour vérifier son état. Si le callback est défini, 'headers' est un champ obligatoire et peut être utilisé pour déclarer tous les en-têtes que l'utilisateur souhaite voir dans le callback (comme par exemple session_id).
POST/IT-richiesta
Dans la réponse, l'id de la demande sera disponible, à utiliser dans une seconde appel pour accéder aux données souhaitées :
{
"data": {
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSMRA90D15L117D",
"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
}
GET/IT-richiesta/{id}
Pour obtenir les données, il sera nécessaire de faire 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
GET/IT-richiesta/{id}
Dans la réponse, il sera possible d'accéder aux informations suivantes :
Le format de réponse sera le suivant :
{
"data": {
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSMRA90D15L117D",
"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": "COMPLETED",
"date_request": "2024-08-26 13:00:00",
"date_completion": "2024-08-26 13:01:00",
"result": {
"cf_piva": "RSSMRA90D15L117D",
"denominazione": "MARIO ROSSI",
"data_nascita": "1990-08-15",
"luogo_nascita": "ROME",
"residenza": "VIA DELLE ROSE 10, 00100 ROME",
"domicilio_fiscale": "VIA DELLE ROSE 10, 00100 ROME",
"telefono": "06 12345678"
}
"success": true,
"message": "Richiesta completata con successo",
"error": null
}
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!