Visengine

  1. Home
  2. API Library
  3. Visengine
Alle offiziellen Dokumente von Handelskammer, INPS und Steuerbehörde

Erhalten Sie beglaubigte Dokumente über Unternehmen, Personen, Immobilien in Echtzeit

All das Wissen, das Sie benötigen

Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.

Nützliche Tipps für den Einstieg Visengine

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.
Lesen Sie mehr über die OAuth-API Meine Tokens verwalten
API docs by Redocly

Visengine 2.0 (2.0.0)

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

Dieser Dienst bietet die Möglichkeit, eine ganze Reihe von Dienstleistungen der Handelskammern, Katasterämter oder des Mäzenatentums für Unternehmen und Privatpersonen in Anspruch zu nehmen

Zum ersten Mal hier? Generieren Sie ein neues Zugangstoken

visure

Abschnitt für Anrufe, der alle verfügbaren Dienste und ihre Eingabeparameter anzeigt

Liste aller Dienstleistungen

Für jedes Element der Liste ist "hash_visura" wichtig, das den Dienst identifiziert

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
}

Mit hash_visura identifizierter Dienst

Dienstbeschreibung mit Eingabeparametern, Preisen und Validierungsanweisungen.

Für diese 4 Visuren:

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

ist es wichtig, die Delegationsdatei herunterzuladen, die dann während der POST/richiesta-Phase hochgeladen werden muss. Der Link zum Herunterladen der Delegationsdatei kann durch Dekodierung des Feldes "istruzioni" des visura-Objekts in Base 64 gefunden werden.

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

hash_visura der zurückzugebenden visura

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

Echte und eigene Aufrufe, um auf Serviceanfragen zuzugreifen, Eingabeparameter einzugeben und zu ändern und die Transaktion abzuschließen

Liste aller Anfragen

Zusammenfassende Liste aller Anfragen, die über Ihr Profil gestellt wurden

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
}

Erstellen einer Anfrage

Aufruf zur Instanziierung einer neuen Dienstanfrage. Es besteht die Möglichkeit, die Anfrage sofort vollständig zu erstellen oder sie durch eine Transaktion mit einem Put abzuschließen.

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

Standardmäßig ist es 1, wenn Sie 0 übergeben, wird die Transaktion nur initialisiert und bleibt offen mit der Möglichkeit, die Felder durch den Put zu ändern

test
boolean

Bei Übergabe von true wird die Validierung der Daten simuliert und die Preise des Dienstes werden ebenfalls zurückgegeben

hash_visura
string

Identifizierung der angeforderten Dienstleistung

object (JsonVisura)

Objekt zur Übergabe aller erforderlichen Eingabefelder, um ein Ausgabedokument aus dem angeforderten Dienst zu erzeugen. Wenn Sie eine Datei übergeben müssen, muss diese wie folgt übergeben werden: name + '|data:' + file type + ';base64,' + base64_encode(file content); Beispiel: '$2' : 'test_file|data:image/png;base64,abcdefghijklmnopqrstuvwxyz0123456789'

object (CallbackData)
email_target
string

Ermöglicht es Ihnen, das angeforderte Dienstleistungsdokument direkt per E-Mail zu erhalten, sobald die Dienstleistung bearbeitet wurde

object

Ermöglicht die Übergabe von Optionen, wenn diese in der "json_struttura" der "visura" angegeben sind

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
}

Findet Anfrage nach _id

Dienst, der Ihre Anfrage zurückgibt, gekennzeichnet durch den im Pfad übergebenen Bezeichner

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

_id der zurückzusendenden Anfrage

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
}

Hinzufügen einer Suche zur Anfrage

Dienste, die den Parameter 'ricerca' : 1 haben, ermöglichen es Ihnen, der ersten Dienstanfrage zusätzliche Suchen hinzuzufügen

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

_id der Anfrage, zu der eine Suche hinzugefügt werden soll

Request Body schema: application/json
object (JsonVisura)

Objekt zur Übergabe aller erforderlichen Eingabefelder, um ein Ausgabedokument aus dem angeforderten Dienst zu erzeugen. Wenn Sie eine Datei übergeben müssen, muss diese wie folgt übergeben werden: name + '|data:' + file type + ';base64,' + base64_encode(file content); Beispiel: '$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
}

Aktualisiert die Anfrage

Mit diesem Aufruf können Sie die Suchfelder der Anfrage aktualisieren und die Transaktion abschließen

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

Anfrage _id

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

Wenn die Transaktion noch offen ist und den Status 0 hat, wird sie nicht validiert und erst dann an das System weitergeleitet, wenn der Status 1 erreicht ist.

object (JsonVisura)

Objekt zur Übergabe aller erforderlichen Eingabefelder, um ein Ausgabedokument aus dem angeforderten Dienst zu erzeugen. Wenn Sie eine Datei übergeben müssen, muss diese wie folgt übergeben werden: name + '|data:' + file type + ';base64,' + base64_encode(file content); Beispiel: '$2' : 'test_file|data:image/png;base64,abcdefghijklmnopqrstuvwxyz0123456789'

json_visura.$n
string

Ermöglicht die Änderung eines einzelnen Eingabefeldes, das für den Dienst erforderlich ist

email_target
string

Ermöglicht es Ihnen, das angeforderte Dienstleistungsdokument direkt per E-Mail zu erhalten, sobald die Dienstleistung bearbeitet wurde

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
}

Aktualisiert die Anfrage mit dem gewählten Index und der Suche

Bei Diensten mit "ricerca": 1 wird das endgültige Dokument bei Auswahl des Suchergebnisses freigegeben

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

Anfrage _id

Request Body schema: application/json
id_ricerca
string

Kennung der Suche, für die wir ein Ergebnis haben

indice
integer

Index des von uns gewählten Suchergebnisses

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

Bereich für die Nutzung des angeforderten Dienstes durch die Ausgabe eines Dokuments

Durch den Antrag erzeugtes Dokument

Ermöglicht die Beschaffung des Dokuments zu einem bestimmten Antrag

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

Anfrage _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