Visengine

  1. Home
  2. API Library
  3. Visengine
All official documents from Chamber of Commerce, INPS and Tax Agency

Get certified documents on companies, people, real estate in real time

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Visengine

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens
API docs by Redocly

Visengine 2.0 (2.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Ce service offre aux appels au repos la possibilité de bénéficier de toute une série de services de la chambre de commerce, du cadastre ou du mécénat liés aux entreprises et aux particuliers.

C'est la première fois que vous venez ici ? Générer un nouveau jeton d'accès

visure

Section dédiée aux appels montrant tous les services disponibles et leurs paramètres d'entrée

Liste de tous les services

Pour chaque élément de la liste, la valeur "hash_visura" est importante, car elle identifie le service.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (Visure)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://visengine2.altravia.com/visure");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Service identifié par hash_visura

Description du service avec les paramètres d'entrée, les prix et les instructions de validation.

Pour ces 4 visites :

  • Annuncio Certificato - 1a0a9d4ba06d2220ecce7da0228416ff
  • Planimétrie Catastale - 4ff728695eab3ab9eaa6f58b22cd5734
  • Fascicolo Casa - 48a2f2616f248bd5809092aae93af9aa
  • Durc Online - 3cbbb9c833f1c94af35494820cda3370

il est important de télécharger le fichier de délégation qui devra ensuite être téléchargé pendant la phase POST/richiesta. Le lien pour télécharger le fichier de délégation peut être trouvé en décodant en base 64 le champ 'istruzioni' de l'objet visura.

Authorizations:
bearerAuth
path Parameters
hash_visura
required
string
Example: 8f14e45fceea167a5a36dedd4bea2543

hash_visura de la visura à retourner

Responses

Response Schema: application/json
object (Visura)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://visengine2.altravia.com/visure/%7Bhash_visura%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

richiesta

Appels réels et propres pour accéder aux demandes de service, pour saisir et modifier les paramètres d'entrée et pour clôturer la transaction.

Liste de toutes les demandes

Liste récapitulative de toutes les demandes effectuées à partir de votre profil

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (Richieste)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://visengine2.altravia.com/richiesta");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Création d'une demande

Appel à l'instanciation d'une nouvelle demande de service. Il est possible de la créer immédiatement ou, grâce à la transactionnalité, de la compléter par une mise à jour.

Authorizations:
bearerAuth
Request Body schema: application/json
state
integer
Enum: 0 1

Par défaut, il est égal à 1. Si vous passez 0, la transaction est seulement initialisée et reste ouverte avec la possibilité de modifier les champs par l'intermédiaire de la fonction Put.

test
boolean

S'il est passé à true, il simule la validation des données et renvoie également les prix du service.

hash_visura
string

Identification du service demandé

object (JsonVisura)

Objet permettant de transmettre tous les champs d'entrée requis pour générer un document de sortie à partir du service demandé. Si vous devez transmettre un fichier, il doit être transmis comme suit : name + '|data:' + file type + ';base64,' + base64_encode(file content) ; exemple : '$2' : 'test_file|data:image/png;base64,abcdefghijklmnopqrstuvwxyz0123456789'

object (CallbackData)
email_target
string

Vous permet de recevoir le document de service demandé directement par courrier électronique une fois le service traité.

object

Permet de passer des options si elles sont fournies dans la 'json_struttura' de la 'visura'

Responses

Response Schema: application/json
object (Richiesta)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "hash_visura": "eccbc87e4b5ce2fe28308fd9f2a7baf3",
  • "json_visura": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Recherche d'une demande par _id

Service qui renvoie votre demande marquée par l'identifiant passé dans le chemin d'accès

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5f22f722065afc42223c7131

Numéro d'identification de la demande à renvoyer

Responses

Response Schema: application/json
object (Richiesta)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://visengine2.altravia.com/richiesta/%7B_id%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Ajouter une recherche à la demande

Les services dont le paramètre "ricerca" est égal à 1 permettent d'ajouter des recherches supplémentaires à la première demande de service.

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5f2829ce065afc21cc60ad0e

ID de la demande d'ajout d'une recherche

Request Body schema: application/json
object (JsonVisura)

Objet permettant de transmettre tous les champs d'entrée requis pour générer un document de sortie à partir du service demandé. Si vous devez transmettre un fichier, il doit être transmis comme suit : name + '|data:' + file type + ';base64,' + base64_encode(file content) ; exemple : '$2' : 'test_file|data:image/png;base64,abcdefghijklmnopqrstuvwxyz0123456789'

Responses

Response Schema: application/json
object (Richiesta)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "json_visura": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Mise à jour de la demande

Cet appel vous permet de mettre à jour les champs de recherche de la demande et de clôturer la transaction.

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5f2829ce065afc21cc60ad0e

demande _id

Request Body schema: application/json
state
integer
Enum: 0 1

Si la transaction est encore ouverte, avec un état à 0, elle ne sera pas validée et transmise au système tant que l'état 1 n'aura pas été transmis.

object (JsonVisura)

Objet permettant de transmettre tous les champs d'entrée requis pour générer un document de sortie à partir du service demandé. Si vous devez transmettre un fichier, il doit être transmis comme suit : name + '|data:' + file type + ';base64,' + base64_encode(file content) ; exemple : '$2' : 'test_file|data:image/png;base64,abcdefghijklmnopqrstuvwxyz0123456789'

json_visura.$n
string

Permet de modifier le champ de saisie unique requis par le service

email_target
string

Vous permet de recevoir le document de service demandé directement par courrier électronique une fois le service traité.

Responses

Response Schema: application/json
object (Richiesta)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "json_visura.$0": "altravia",
  • "state": 1
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Met à jour la demande avec l'index et la recherche choisis

Dans les services avec "ricerca" : 1 le document final est publié dès le choix du résultat de la recherche

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5f283eae065afc21cf466ea4

demande _id

Request Body schema: application/json
id_ricerca
string

Identifiant de la recherche pour laquelle nous avons un résultat

indice
integer

Index du résultat de recherche que nous avons choisi

Responses

Response Schema: application/json
object (Richiesta)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "id_ricerca": "5f283eae065afc21cf466ea4_0",
  • "indice": 1
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

documento

Espace dédié à l'utilisation du service demandé à travers l'édition d'un document

Document généré par la demande

Permet d'obtenir le document relatif à une demande spécifique

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5f22f5b5065afc21cc60a27a

demande _id

Responses

Response Schema: application/json
object (Allegato)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://visengine2.altravia.com/documento/%7B_id%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}
Web Service Revision: 2.0.0