Post Office

  1. Home
  2. API Library
  3. Post Office
Alle Ihre Sendungen über API und in Echtzeit

Automatisieren Sie den Versand von Dokumenten, Einschreiben, Telegrammen, Werbung mit der Post<br>

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 Post Office

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

Ufficio Postale (1.0.0)

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

Dieser Webservice ermöglicht die Zustellung von Postprodukten wie Raccomandate, Telegrammi, Posta Prioritaria durch Poste Italiane

  1. Erstellen Sie eine neue Mail mit einer POST-Anfrage
  2. Prüfen Sie die Preise und bestätigen Sie sie mit einem PATCH, oder verwenden Sie autoconfirm: true
  3. Empfangen Sie die Status-Updates Ihrer Mail, indem Sie eine callback url

Hinweis: Es gibt einige Einschränkungen bezüglich der Größe eines PDF-Dokuments. Bitte lesen Sie das Feld "Dokument" in der Beschreibung des Endpunkts, den Sie verwenden möchten.

Fehlerbehandlung

Wenn ein Sendefehler auftritt, enthält die Antwort eine Meldung und ein data.wrong_fields: []: Jedes Element von falsche_Felder ist eine Zeichenkette, die angibt, von wo aus der Fehler erzeugt wurde. Dies macht es sehr einfach, in Ihr Front-End-Formular zu integrieren, wo Sie die falschen Einträge hervorheben können

Testing

Wenn Sie die Sandbox-Umgebung verwenden, erhalten Sie kurz nach der Erstellung der Anfrage Aktualisierungs-Callbacks mit Platzhalterinhalten. Bei einigen Produkten ist es auch möglich, die Ausführung des Callbacks in der Sandbox-Umgebung zu erzwingen.

Zum ersten Mal hier? Generieren Sie ein neues Zugangstoken

Ufficio Postale

Preise erhalten

Liefert eine Liste von Preisen für verschiedene Arten von Dienstleistungen

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/pricing/");

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

OK

{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Liste der Adressen

Authorizations:
bearerAuth
query Parameters
cap
string
Example: cap=05100
comune
string
Example: comune=terni
dug
string
Example: dug=via

Responses

Response Schema: application/json
data
Array of strings
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/indirizzi/?cap=SOME_STRING_VALUE&comune=SOME_STRING_VALUE&dug=SOME_STRING_VALUE");

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": "string",
  • "error": null
}

Liste aller verfügbaren Drogen

(generische städtische Bezeichnungen)

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/dug/");

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": [
    ],
  • "message": "1 Risultato",
  • "success": true,
  • "error": null
}

Verfolgen Sie Ihr Produkt

Authorizations:
bearerAuth
path Parameters
id
required
string

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/tracking/%7Bid%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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Informationen über eine Postleitzahl abrufen Deprecated

Authorizations:
bearerAuth
path Parameters
code
required
string
Example: 05100

Responses

Response Schema: application/json
object
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/comuni/05100");

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

OK

{
  • "data": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Telegrammi

Informationen über ein Telegramm abrufen

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
ricevuta
string
Example: ricevuta=1

Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben

state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

Responses

Response Schema: application/json
object
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/telegrammi/%7Bid%7D?ricevuta=1&state=NEW");

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": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Bestätigen Sie den Versand eines Telegramms

Bestätigen Sie das Senden eines Telegramms, das mit "autoconfirm = false" erstellt wurde.

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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

Liste Ihrer Telegramme

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/telegrammi/");

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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie ein Telegramm. Sie sollten Informatione

Senden Sie ein Telegramm. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Zusätzlich kann der Parameter "autoconfirm" auf false gesetzt werden, um das Telegramm für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen.

Authorizations:
bearerAuth
Request Body schema: application/json
object
object
Array of objects (Recipient)
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

Response Schema: application/json
object
object
Array of objects
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

object (documento_validato)

Die Ausgabe des Dokumentenerstellungsprozesses.

Callbacks

Request samples

Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": [
    ],
  • "documento": [
    ],
  • "opzioni": {
    }
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Raccomandate

Dieses Produkt bietet einen Tracking-Code

List your Raccomandate

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate/");

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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie ein Raccomandat. Sie sollten Informatio

Senden Sie ein Raccomandat. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Zusätzlich kann der Parameter "autoconfirm" auf false gesetzt werden, um die Raccomandata für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen. Überprüfen Sie das Feld NumeroRaccomandata im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen

Authorizations:
bearerAuth
Request Body schema: application/json
object
object
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale)
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

Response Schema: application/json
object
object
Array of objects
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

object (documento_validato)

Die Ausgabe des Dokumentenerstellungsprozesses.

Callbacks

Request samples

Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": [
    ],
  • "documento": [
    ],
  • "opzioni": {
    }
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Informationen über eine Raccomandate erhalten

Überprüfen Sie das Feld NumeroRaccomandata im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
ricevuta
string
Example: ricevuta=1

Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben

state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

callback
string
Example: callback=<empty string>

Simuliert den Fortschritt des Versandstatus: Jedes Mal, wenn dieser Endpunkt aufgerufen wird, schreitet Ihre Anfrage zum nächsten Versandstatus.
Wenn in der Anfrage angegeben, erhalten Sie Callback-Updates.
Bitte beachten Sie, dass diese Option NUR für die Sandbox-Umgebung verfügbar ist.

Responses

Response Schema: application/json
object
message
string
success
boolean
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate/%7Bid%7D?ricevuta=1&state=NEW&callback=%3Cempty%20string%3E");

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": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Bestätigen Sie den Versand einer Raccomandate, die

Bestätigen Sie den Versand einer Raccomandate, die mit "autoconfirm = false" erstellt wurde

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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

Posta Prioritaria

Dieses Produkt bietet einen Code zur Verfolgung von Statusaktualisierungen

Ihre Anfragen auflisten

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/prioritarie/");

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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie eine Prioritätssendung. Sie sollten im

Senden Sie eine Prioritätssendung. Sie sollten im Nachrichtentext Informationen über den Absender und den/die Empfänger angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um die Mail für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen. Überprüfen Sie das Feld IdRicevuta im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen.

Authorizations:
bearerAuth
Request Body schema: application/json
object
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale)
object
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

Response Schema: application/json
object
object
Array of objects
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

object (documento_validato)

Die Ausgabe des Dokumentenerstellungsprozesses.

Callbacks

Request samples

Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": [
    ],
  • "documento": [
    ],
  • "opzioni": {
    }
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Informationen über eine einzelne Prioritätssendung erhalten

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
ricevuta
string
Example: ricevuta=1

Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben

state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

Responses

Response Schema: application/json
object
message
string
success
boolean
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/prioritarie/%7Bid%7D?ricevuta=1&state=NEW");

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": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Bestätigen Sie den Versand einer E-Mail, die mit "

Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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

Posta Ordinaria

Ihre Anfragen auflisten

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
success
boolean
message
string
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/ordinarie/");

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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie eine Standard-Mail. Sie sollten Informa

Senden Sie eine Standard-Mail. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um die E-Mail für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen.

Authorizations:
bearerAuth
Request Body schema: application/json
object
object
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale)
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

Response Schema: application/json
object
object
Array of objects
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

object (documento_validato)

Die Ausgabe des Dokumentenerstellungsprozesses.

Callbacks

Request samples

Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": [
    ],
  • "documento": [
    ],
  • "opzioni": {
    }
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Informationen über eine einzelne E-Mail abrufen

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
ricevuta
string
Example: ricevuta=1

Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben

state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

Responses

Response Schema: application/json
object
message
string
success
boolean
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/ordinarie/%7Bid%7D?ricevuta=1&state=NEW");

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": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Bestätigen Sie den Versand einer E-Mail, die mit "

Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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

Raccomandata Smart

Ihr raccomandate_smart auflisten

Ihr raccomandate_smart auflisten

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects
message
string
success
boolean
error
any

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate_smart/");

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": [
    ],
  • "message": "1 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie einen Raccomandata Smart. Sie sollten I

Senden Sie einen Raccomandata Smart. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um ihn für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen.

Authorizations:
bearerAuth
Request Body schema: application/json
object
object
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale)
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

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

Callbacks

Request samples

Content type
application/json
{
  • "mittente": [
    ],
  • "destinatari": [
    ],
  • "documento": [],
  • "opzioni": {}
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Listen Sie Ihre einzelnen raccomandata smart

Listen Sie Ihre einzelnen raccomandata smart

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

Responses

Response Schema: application/json
object (ExampleState)
object
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://ws.ufficiopostale.com/raccomandate_smart/%7Bid%7D?state=NEW");

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
}

Bestätigen Sie den Versand einer E-Mail, die mit "

Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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

Posta Massiva

Ihr posta_massiva auflisten

Ihr posta_massiva auflisten

Authorizations:
bearerAuth

Responses

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

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/posta_massiva/");

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": [
    ],
  • "message": "3 Risultati",
  • "success": true,
  • "error": null
}

Senden Sie ein posta_massiva. Sie sollten Informat

Senden Sie ein posta_massiva. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um ihn für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen.

Authorizations:
bearerAuth
Request Body schema: application/json
object
object
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale)
Array of strings or string (documento)

Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die Strings können entweder sein:

  • Einfacher Text
  • Formatiert in HTML, mit Stil, Kopfzeilen-Tags usw..
  • Eine URL, die entweder auf eine Webseite, ein PDF oder eine Bilddatei verweist (Urls müssen mit http beginnen). Der Inhalt wird aus dem "Content-Type"-Header abgeleitet
  • Eine base64-kodierte PDF-Datei. Kodierte Zeichenketten werden durch den base64-Content-Header data:application/pdf;base64, abgeleitet: um eine Zeichenkette als base64-kodierten Inhalt zu kennzeichnen, sollte man die oben genannte Zeichenkette der Ausgabe voranstellen.
    Die Anfrage gibt einen Fehler zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt

Der Dienst analysiert das Feld "documento" (Dokument), führt alle Strings/Dokumente/Bilder in verschiedenen Seiten zusammen, komprimiert sie leicht (wenn möglich) und erzeugt eine einzige PDF-Datei.

Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB).

Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro".

Responses

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

Callbacks

Request samples

Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": [
    ],
  • "documento": [
    ],
  • "opzioni": {
    }
}

Response samples

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

Callback payload samples

Callback
POST: {$request.body#/opzioni/callback_url}
Content type
application/json
{
  • "mittente": {
    },
  • "destinatari": {
    },
  • "documento": [
    ],
  • "opzioni": {
    },
  • "prodotto": "string",
  • "creation_timestamp": 0,
  • "update_timestamp": 0,
  • "username": "string",
  • "confirmed": true,
  • "state": "string",
  • "documento_validato": {
    },
  • "pricing": {
    },
  • "confirmed_timestamp": 0,
  • "id": "string"
}

Ihre Einzelperson posta_massiva auflisten

Ihre Einzelperson posta_massiva auflisten

Authorizations:
bearerAuth
path Parameters
id
required
string
query Parameters
state
string
Example: state=NEW

Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben.

Responses

Response Schema: application/json
object
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://ws.ufficiopostale.com/posta_massiva/%7Bid%7D?state=NEW");

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
}

Bestätigen Sie den Versand einer E-Mail, die mit "

Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.

Authorizations:
bearerAuth
path Parameters
id
required
string
Request Body schema: application/json
confirmed
boolean

Responses

Request samples

Content type
application/json
{
  • "confirmed": true
}

Response samples

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