Visengine

  1. Home
  2. Bibliothèque d'API
  3. Visengine
Tous les documents officiels de la Chambre de Commerce, de l'INPS et de l'Agence Fiscale

Obtenez des documents certifiés sur les entreprises, les personnes, les biens immobiliers en temps réel

Toutes les connaissances dont vous avez besoin

Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.

Conseils utiles pour commencer Visengine

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.
En savoir plus sur l'API oauth Gérer mes jetons
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