Recherche Free Lances

Le service Risk Libero Professionista fait partie de l'API RISK et permet d'obtenir, à partir du paramètre code fiscal, une série d'informations utiles pour l'identification de la résidence, du domicile fiscal et du numéro de téléphone, ainsi que pour la vérification des éventuels événements négatifs d'un professionnel.

Le service est identifié par l'endpoint https://risk.openapi.com/IT-richiesta.

Risk Libero Professionista permet, avec une seule demande, d'obtenir la dénomination, le siège légal, le code et la description ATECO, les négativités et le numéro de téléphone.

EXEMPLE DE DEMANDE

POST/richiesta

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

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

Les paramètres à passer dans le corps de l'appel sont :

Ceci est un exemple des paramètres à utiliser pour une demande avec le code fiscal RSSMRA90D15L117D :

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

Il est également possible de demander seulement une partie des informations. Dans ce cas, il sera possible d'indiquer dans le champ type le dataset d'informations souhaité (anagrafica, negativita ou telefoni) ou d'utiliser directement les endpoints spécifiques pour chaque dataset lors de la demande.

La réponse est asynchrone et il est possible de configurer, lors de la demande, également un callback pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET/richiesta/{id} pour vérifier son état. En cas de configuration du callback, 'headers' est un champ obligatoire et peut être utilisé pour déclarer tous les headers que l'utilisateur souhaite voir dans le callback (comme par exemple session_id).

EXEMPLE DE RÉPONSE

POST/richiesta

Dans la réponse, l'id de la demande sera disponible, à utiliser dans une seconde demande pour accéder aux données souhaitées :

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "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
  }

EXEMPLE DE DEMANDE

GET/IT-richiesta/{id}

Pour obtenir les données, il sera nécessaire d'effectuer une seconde demande, comme mentionné précédemment, à un autre endpoint avec l'ID précédemment obtenu :

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

EXEMPLE DE RÉPONSE

GET/IT-richiesta/{id}

Dans la réponse, il sera possible d'accéder aux informations suivantes :

Les données retournées sont au format JSON.