Check Risk Persona (All)

Il servizio Check Risk Persona (ALL) appartiene all'API RISK e consente, a partire dal parametro codice fiscale, di ottenere una serie di informazioni utili alla verifica e all'individuazione di un privato.

Risk Persona consente con un'unica richiesta di ottenere:

•  nome e cognome
• residenza
• negatività
• telefono.

Il servizio è identificato dall'endpoint https://risk.openapi.com/IT-richiesta.

ESEMPIO RICHIESTA

POST /richiesta

Il metodo da utilizzare nella richiesta è POST:

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

I parametri da passare nel body della chiamata sono:

Questo è un esempio dei parametri necessari per una richiesta con codice fiscale DRSCLD70P15H501V:

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

È possibile richiedere anche solo una parte delle informazioni. In questo caso, è sufficiente specificare nel campo tipo il dataset desiderato (anagrafica, negatività o telefoni), oppure utilizzare direttamente gli endpoint dedicati a ciascun dataset nella fase di richiesta.

La risposta è asincrona ed è possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET /richiesta/{id} per verificarne lo stato. In caso venga impostata la callback, 'headers' è un campo obbligatorio e può essere utilizzato per dichiarare tutti gli headers che l'utente vorrebbe venissero indicati nella callback (come ad esempio session_id).

ESEMPIO RISPOSTA

POST /richiesta

Nella risposta sarà disponibile l'id della richiesta da utilizzare in una seconda chiamata per avere accesso ai dati desiderati:

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

ESEMPIO RICHIESTA

GET /IT-richiesta/{id}

Per ottenere i dati sarà necessario effettuare una seconda richiesta, come anticipato, ad un altro endpoint con l'ID precedentemente ottenuto.

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

ESEMPIO RISPOSTA

GET /IT-richiesta/{id}

Nella risposta sarà possibile accedere alle seguenti informazioni:

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

Il servizio Check Risk Persona (ALL) è ideale per tutte quelle aziende che necessitano di effettuare una verifica rapida su un soggetto ed ottenere informazioni in maniera veloce su residenza, negatività e telefono. Attualmente l'API è utilizzata ad esempio da Banche e Istituti Finanziari, Agenzie di Recupero Crediti, Società di Assicurazioni.

CONDIZIONI E MODALITA'DI UTILIZZO DEL SERVIZIO

Il servizio, nonostante sia disponibile in modalità automatica tramite API, per motivi di normativa è sottoposto a monitoraggio continuo dei LOG con le seguenti limitazioni:

Le richieste effettuate in altri orari o giorni vanno in coda e sono lavorate in modalità prioritaria il primo giorno lavorativo.

Il servizio come da condizioni contrattuali ha vincoli di rate limit giornalieri impostati per una corretta gestione del servizio.

Se desideri avere un servizio personalizzato contattaci qui.