Telefono Persona

Il servizio Telefono Persona appartiene all'API RISK e consente, dal solo parametro codice fiscale, di ottenere il numero telefonico di un privato, nel pieno rispetto delle normative vigenti in termini di privacy.

Trattandosi di un'informazione sensibile, può essere richiesta solamente da chi ha un diritto giuridicamente rilevante.

ESEMPIO RICHIESTA

POST/telefoni

Il metodo da utilizzare nella richiesta è POST:

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

I parametri da passare nel body della chiamata sono:

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

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

La risposta è asincrona. È 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.

ESEMPIO RISPOSTA

POST/telefoni

Segue l'esempio di una risposta in pending (cioè in attesa del risultato) e dove sarà possibile ottenere l'id della richiesta da utilizzare in una seconda chiamata per poter accedere ai dati desiderati.

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "telefoni"
      ],
      "callback": false,
      "url" false,
      "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.

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

ESEMPIO RISPOSTA

GET /IT-richiesta/{id}

Nella risposta sarà possibile ottenere il numero telefonico (utenza fissa o mobile, in base alla disponibilità).

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2023-07-09 17:09:42",
      "date_completion": "2023-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "telefoni"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "imprese@openapi.it",
      "soggetto": {
        "code": "RSSMRA90D15L117D"
        "utenze": ["3331234567"]
          ]
        },        
    "success": true,
    "message": "",
    "error": null
  }
  

Il servizio Telefono Persona-Risk è disponibile anche per ricerche su Liberi Professionisti e su Aziende.

MODALITÀ E CONDIZIONI DI UTILIZZO DEL SERVIZIO

Come anticipato sopra, ricordiamo che tale servizio può essere richiesto unicamente a fronte di un diritto giuridicamente rilevante (qualunque posizione soggettiva tale da configurare un rapporto di strumentalità tra tale interesse e la documentazione di cui si chiede l'ostensione).

Per sua natura il servizio può dare anche risposta nulla (es. nessun dato in database pubblici o di pubblico accesso); il servizio comporta anche in questo caso un costo. Il cliente, al momento della richiesta, dichiara di avere un diritto rilevante (es. recupero del credito), in caso di dichiarazione mendace si ricorda che la richiesta viene comunicata trimestralmente agli uffici della Prefettura con le relative conseguenze di dichiarazioni mendaci.

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.

Telefono Persona, come da condizioni contrattuali, ha vincoli di rate limite giornalieri impostati per una corretta gestione del servizio.

Se desideri avere una proposta personalizzata contattaci qui.

Il servizio viene già utilizzato da aziende di recupero crediti, avvocati, banche e studi legali, che hanno un interesse legittimo nel contattare persone fisiche o giuridiche relativamente ad obblighi finanziari in sospeso, o per poter notificare atti e documenti legali.