This web service allows the delivery of postal products like Raccomandate, Telegrammi, Posta Prioritaria through Poste Italiane
message
and a data.wrong_fields: []
: each element of wrong_fields
is a string which indicates where the error was generated from. This makes it very easy to integrate in your front-end form, where you can highlight the wrong entriesArray of objects[ items ] | |
success | boolean |
message | string |
error | any |
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);
{- "data": [
- {
- "mittente": {
- "nome": "Alberto",
- "cognome": "Rossi",
- "email": "john.doe@openapi.it"
}, - "creation_timestamp": 1608040424,
- "update_timestamp": 1608040424,
- "confirmed": false,
- "state": "NEW",
- "id": "5fd8bfeaa10b340e2e558db7"
}
], - "message": "1 Risultati",
- "success": true,
- "error": null
}
Send a Raccomandata. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the Raccomandata for a later confirmation with a PATCH request, while you do custom logic with the response. Check the NumeroRaccomandata field in the recipient object if you need the tracking number
object | |
object | |
Array of Recipient (object) or Casella postale (object) <= 2 items [ items ] | |
Array of strings or string (documento) The document can either be a string or an array of strings in plain text.
The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 50, or 100 is using the |
object | |
object | |
Array of objects[ items ] | |
Array of strings or string (documento) The document can either be a string or an array of strings in plain text.
The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 50, or 100 is using the | |
object (documento_validato) The output of the document generation process. |
{- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "john.doe@openapi.it"
}, - "destinatari": [
- {
- "nome": "Mario",
- "cognome": "Rossi",
- "co": "OPENAPI SRL",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "6",
- "comune": "Roma",
- "cap": "00101",
- "provincia": "RE",
- "nazione": "Italia"
}, - {
- "nome": "Mario",
- "cognome": "Rossi",
- "co": "OPENAPI SRL",
- "dug": "piazza",
- "indirizzo": "San Giovanni",
- "civico": "6",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia"
}
], - "documento": [
- "Example document"
], - "opzioni": {
- "fronteretro": false,
- "colori": false,
- "ar": true,
- "autoconfirm": true
}
}
{- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "john.doe@openapi.it"
}, - "destinatari": [
- {
- "nome": "Mario",
- "cognome": "Rossi",
- "co": "OPENAPI SRL",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "6",
- "comune": "Roma",
- "cap": "00101",
- "provincia": "RE",
- "nazione": "IT",
- "id": "6103f711dd2507415c5db6ce",
- "state": "NEW"
}, - {
- "nome": "Mario",
- "cognome": "Rossi",
- "co": "OPENAPI SRL",
- "dug": "piazza",
- "indirizzo": "San Giovanni",
- "civico": "6",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "id": "6103f711dd2507415c5db6cf",
- "state": "NEW"
}
], - "documento": [
- "Example document"
], - "opzioni": {
- "fronteretro": false