Daten zu Personen

Der Daten zu Personen gehört zur API RISK und ermöglicht es Ihnen, mithilfe des Parameters Steuernummer eine Reihe nützlicher Informationen zur Überprüfung, Identifizierung und Bestätigung der Existenz einer Person zu erhalten.

Daten zu Personenermöglicht den Zugriff auf die folgenden Informationen über die

Der Dienst ist über den Endpunkt https://risk.openapi.com/IT-anagrafica erreichbar.

BEISPIELANFRAGE

POST/anagrafica

Die zu verwendende Methode bei der Anfrage ist POST:

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

Die Parameter, die im Anfragetext übergeben werden müssen, sind:

Hier ist ein Beispiel für die notwendigen Parameter bei einer Anfrage mit der Steuernummer RSSMRA90D15L117D:

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

Die Antwort erfolgt asynchron. Es ist möglich, einen Callback während der Anforderung festzulegen, um Benachrichtigungen zu erhalten, wenn die Daten verfügbar sind, ohne den Endpunkt GET/IT-richiesta/{id} mehrmals aufrufen zu müssen, um den Status zu überprüfen. Wenn ein Callback definiert ist, ist 'headers' ein erforderliches Feld und kann verwendet werden, um alle Header anzugeben, die der Benutzer im Callback einfügen möchte (z. B. session_id).

BEISPIELANTWORT

POST/IT-anagrafica

Die Antwort enthält die Anfrage-ID, die für einen zweiten Aufruf verwendet werden kann, um auf die gewünschten Daten zuzugreifen.

{
    "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
  }
  

BEISPIELANFRAGE

GET/IT-richiesta/{id}

Um die Daten zu erhalten, muss eine zweite Anfrage an einen anderen Endpunkt mit der zuvor erhaltenen ID gestellt werden.

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

BEISPIELANTWORT

GET/IT-richiesta/{id}

In der Antwort sind die folgenden Informationen über die Person enthalten: Vorname und Nachname, Wohnadresse, Geburtsdatum und -ort, Geschlecht, Lebensstatus und gegebenenfalls das Todesdatum.

{
    "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": "404",
        "descrizione": "Anfrage erfolgreich bearbeitet"
      },
      "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
  }
  

Der Service ist ideal für Unternehmen, die schnell Informationen über eine Privatperson überprüfen und aktualisieren müssen. Zu den Unternehmenstypen, die die API bereits integriert haben, gehören Inkassobüros, Ermittlungsagenturen, Banken- und Versicherungsinstitute, Notare und Anwälte.

Der Dienst „Personenbezogene Daten“ ist auch für Suchen nach Freelancern und Unternehmen verfügbar.

Ebenso kann das Abonnement des Dienstes „Personenbezogene Daten“ für Suchen nach Freelancern, Unternehmen und Einzelpersonen verwendet werden.

ALLGEMEINE NUTZUNGSBEDINGUNGEN DES DIENSTES

Obwohl der Dienst im automatischen Modus über die API verfügbar ist, unterliegt der Dienst aus regulatorischen Gründen einer kontinuierlichen Protokollüberwachung mit den folgenden Einschränkungen:

Anfragen, die außerhalb dieser Zeiten oder Tage eingehen, werden in eine Warteschlange gestellt und am nächsten Werktag vorrangig bearbeitet.

Gemäß den vertraglichen Bedingungen hat der Dienst tägliche Rate-Limits, die für eine korrekte Verwaltung des Dienstes festgelegt sind.
Diese Limits variieren je nach Abonnement:

Wenn das Rate-Limit des Abonnements überschritten wird, werden die Aufrufe auf das Guthaben des Portfolios berechnet.

Wenn Sie einen maßgeschneiderten Service wünschen, kontaktieren Sie uns hier.