Risikoüberprüfung für Einzelpersonen (Alle)

Der Risk Persona-Dienst gehört zur API RISK und ermöglicht es, anhand des Parameters Steuernummer eine Reihe nützlicher Informationen zur Überprüfung und Identifizierung einer Privatperson zu erhalten.

Risk Persona ermöglicht es, mit einer einzigen Anfrage:

• Name und Nachname
• Wohnsitz
• Negativmerkmale
• Telefonnummer

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

BEISPIELANFRAGE

POST /IT-richiesta

Die Methode, die bei der Anfrage verwendet werden soll, ist POST:

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

Die Parameter, die im Body der Anfrage übergeben werden müssen, sind:

Dies ist ein Beispiel für die benötigten Parameter für eine Anfrage mit der Steuernummer DRSCLD70P15H501V:

{
      "cf_piva": "DRSCLD70P15H501V",  
      "tipo": [
        "anagrafica",  "negativita","telefoni"
        ]
      "callback": {
        "url": "https://yourdomain.com/your_script",
        "method": "POST",
        "field": "data",    
        "headers": {
          "session_id": "oiwejdf89453urf945jfg"
        }
      }
    }
    

Es ist auch möglich, nur einen Teil der Informationen anzufordern. In diesem Fall können Sie im Feld Typ das gewünschte Datenset (Personenstammdaten, Negativmerkmale oder Telefonnummern) angeben oder direkt die spezifischen Endpunkte für jedes Datenset verwenden.

Die Antwort erfolgt asynchron, und es ist möglich, bei der Anfrage auch einen Callback einzurichten, um informiert zu werden, wann die Daten verfügbar sind, ohne mehrfach den Endpunkt GET /IT-richiesta/{id} abfragen zu müssen, um den Status zu überprüfen. Wenn der Callback eingerichtet wird, ist 'headers' ein Pflichtfeld und kann verwendet werden, um alle Header zu deklarieren, die der Benutzer im Callback angegeben haben möchte (z.B. session_id).

BEISPIEL ANTWORT

POST /IT-richiesta

In der Antwort wird die ID der Anfrage bereitgestellt, die in einem zweiten Aufruf verwendet werden kann, um auf die gewünschten Daten zuzugreifen:

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

BEISPIEL ANFRAGE

GET /IT-richiesta/{id}

Um die Daten zu erhalten, ist es notwendig, eine zweite Anfrage an einen anderen Endpunkt mit der zuvor erhaltenen ID zu stellen.

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

BEISPIEL ANTWORT

GET /IT-richiesta/{id}

In der Antwort können die folgenden Informationen abgerufen werden:

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

Der Check Risk Persona (ALL) Dienst ist ideal für Unternehmen, die eine schnelle Überprüfung einer Person durchführen und Informationen wie Wohnsitz, Negativvermerke und Telefonnummer zügig erhalten müssen. Derzeit wird die API beispielsweise von Banken und Finanzinstituten, Inkassounternehmen und Versicherungsgesellschaften genutzt.

Der Risk Persona-Dienst ist auch für Recherchen zu Unternehmen und Freiberuflern verfügbar.

BEDINGUNGEN UND NUTZUNGSBEDINGUNGEN DES DIENSTES

Der Dienst, obwohl er automatisch über die API verfügbar ist, unterliegt aus regulatorischen Gründen einer kontinuierlichen Überwachung der LOGS mit den folgenden Einschränkungen:

Anfragen, die zu anderen Zeiten oder an anderen Tagen gestellt werden, werden in die Warteschlange eingereiht und am ersten Werktag vorrangig bearbeitet.

Der Dienst hat gemäß den vertraglichen Bedingungen tägliche Rate-Limit-Beschränkungen, die für eine korrekte Verwaltung des Dienstes festgelegt sind.

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