Données Personnelles

Le service de Données Personnelles appartient à l'API RISK et, en utilisant le paramètre numéro fiscal, permet d'obtenir une gamme d'informations utiles pour la vérification, l'identification et la confirmation de l'existence d'une personne.

Le service est identifié par le point de terminaison https://risk.openapi.com/IT-anagrafica.

EXEMPLE DE REQUÊTE

POST/IT-anagrafica

La méthode à utiliser dans la demande est POST :

POST https://risk.openapi.com/IT-anagrafica

Les paramètres à passer dans le corps de la demande sont :

Voici un exemple des paramètres nécessaires pour une demande avec le numéro fiscal RSSMRA90D15L117D :

{
  "cf_piva": "RSSMRA90D15L117D",  
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "field": "data",
    "method": "POST",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

La réponse est asynchrone. Il est possible de définir un callback pendant la phase de demande pour être mis à jour lorsque les données sont disponibles, sans avoir à appeler plusieurs fois le point de terminaison GET/IT-richiesta/{id} pour vérifier son statut. Si un callback est défini, 'headers' est un champ requis et peut être utilisé pour déclarer tous les en-têtes que l'utilisateur souhaite inclure dans le callback (par exemple, session_id).

EXEMPLE DE RÉPONSE

POST/IT-anagrafica

La réponse inclura l'ID de la demande, à utiliser dans un deuxième appel pour accéder aux données souhaitées.

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "anagrafica"
      ],
      "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 REQUÊTE

GET/IT-richiesta/{id}

Pour obtenir les données, une deuxième demande doit être effectuée, comme mentionné précédemment, à un autre point de terminaison avec l'ID obtenu précédemment.

POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e

EXEMPLE DE RÉPONSE

GET/IT-richiesta/{id}

La réponse fournira un accès aux informations suivantes :

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-07-09 17:09:42",
      "date_completion": "2021-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "anagrafica"
      ],
      "callback": false,
      "esito": {
        "codice": 200,
        "descrizione": "Richiesta elaborata con successo"
      },
      "owner": "test@openapi.com",
      "soggetto": {
        "code": "RSSMRA90D15L117D",
        "code_conferma": "RSSMRA90D15L117D",
        "risultato": "OK",
        "nome": "Claudio",
        "cognome": "De Rossi",
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": ROMA,       
        "nascita_data": 1970-01-15,       
        "sesso": M,    
        "residenza": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        },
        "domicilio fiscale": null,
        "denominazione": De Rossi Claudio,
        "partita_iva": null,
        "sede_legale": null
        }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

Le service de Données Personnelles est également disponible pour les recherches sur les Freelancers et les Entreprises.

De même, l'abonnement au service de Données Personnelles peut être utilisé pour les recherches sur les freelancers, les entreprises, et les individus.

CONDITIONS GÉNÉRALES D'UTILISATION DU SERVICE

Bien qu'étant disponible en mode automatique via l'API, pour des raisons réglementaires, le service est soumis à un suivi continu des LOG avec les limitations suivantes :

Les demandes effectuées en dehors de ces heures ou jours seront mises en file d'attente et traitées en priorité le jour ouvrable suivant.

Conformément aux conditions contractuelles, le service a des limites de taux quotidiennes définies pour une gestion correcte du service.
Ces limites varient en fonction de l'abonnement :

Si la limite de taux de l'abonnement est dépassée, les appels seront facturés au crédit du portefeuille.

Si vous souhaitez un service personnalisé, contactez-nous ici.