PEC Massiva

  1. Home
  2. Libreria API
  3. PEC Massiva
La soluzione più semplice e sicura per l’invio di PEC Massive

Gestisci ed automatizza l’invio di grosse quantità di messaggi di Posta Elettronica Certificata via API

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con PEC Massiva

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Approfondisci Oauth Gestisci i tokens
API docs by Redocly

PEC Massiva 1.0 (1.0.0)

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

Questo servizio offre chiamate di riposo per l'invio massivo di pec e il controllo dello stato delle email di verifica della consegna e della ricezione.

Prima volta qui? Generare un nuovo token di accesso

PEC

Elenco di tutte le e-mail relative a un determinato invio

Riporta lo stato delle email di ricezione e verifica della consegna relative all'invio con il codice restituito al momento dell'invio della PEC

Authorizations:
bearerAuth
path Parameters
code
required
string
Example: 2020082610003492

Codice restituito al momento dell'invio della PEC

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Response Schema: application/json
Array of objects (ResponseStatus)
success
boolean
message
string

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/send/%7Bcode%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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": ""
}

Eliminare tutti i messaggi di posta elettronica relativi a un determinato invio.

Eliminare la ricevuta e la verifica di consegna di un'e-mail inviata dalla propria INBOX

Authorizations:
bearerAuth
path Parameters
code
required
string
Example: 2020082610003492

Codice restituito al momento dell'invio della PEC

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/send/%7Bcode%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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
{
  • "success": true,
  • "message": "Operation succefull"
}

Inviare una PEC al destinatario inviato

Invia una PEC al destinatario inviato e restituisce il codice identificativo della spedizione che può essere utilizzato per restituire le informazioni sulle email di conferma di ricezione e consegna.
I destinatari possono essere uno o molti: è possibile specificare un singolo indirizzo o un array di destinatari

Si prega di notare che questo endpoint può gestire fino a 1 richiesta/secondo.

Authorizations:
bearerAuth
Request Body schema: application/json
sender
string
string or Array of strings

Invia un messaggio di posta elettronica a uno o più destinatari. Questo campo accetta una stringa o un array di stringhe.

subject
string
body
string
object (Attachment)
username
string
password
string

Responses

Response Schema: application/json
success
boolean
message
string
message_id
string
sent
integer

Numero di e-mail PEC inviate

Request samples

Content type
application/json
{
  • "sender": "[email protected]",
  • "recipient": [],
  • "subject": "Invio di prova pec massiva",
  • "body": "Salve, questa rappresenta una prova di invio, che prevede un <b>corpo in html</b>",
  • "attachments": [
    ],
  • "username": "your_pec_username",
  • "password": "your_pec_password"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "sent": 1,
  • "message": "",
  • "message_id": "2020082610003492"
}

Inbox

Restituisce un singolo messaggio nella INBOX

Restituisce un singolo messaggio. Si noti che il corpo sarà una stringa codificata in x-www-form-urlencoded

Authorizations:
bearerAuth
path Parameters
id
required
number
Example: 3

L'id del messaggio ricevuto da /inbox

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Response Schema: application/json
object (InboxSingle)
success
boolean
message
string

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/inbox/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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": ""
}

Cancellare un'e-mail

Eliminare la ricevuta e la verifica di consegna di un'e-mail inviata dalla propria INBOX

Authorizations:
bearerAuth
path Parameters
id
required
number
Example: 3

L'id del messaggio ricevuto da /inbox

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/inbox/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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
{
  • "success": true,
  • "message": "Message deleted"
}

Ottenere un elenco di e-mail nella propria casella di posta elettronica

Restituisce il contenuto della propria INBOX. I risultati possono essere paginati: ogni pagina contiene fino a 25 messaggi e ha un ID univoco che può essere utilizzato in seguito per ottenere il singolo messaggio o cancellarlo. <Inoltre, è possibile effettuare una query utilizzando il parametro 'q'. Si noti che la ricerca su una casella di posta molto popolata può essere lenta.

Authorizations:
bearerAuth
query Parameters
q
string

Criteri di ricerca

page
number

Pagina attuale

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Response Schema: application/json
Array of objects (InboxSearch)
success
boolean
message
string
page
number
total
number
n_of_pages
number

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/inbox?q=SOME_STRING_VALUE&page=SOME_NUMBER_VALUE");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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": "",
  • "total": 981,
  • "page": 39,
  • "n_of_pages": 39
}

Restituisce l'utilizzo dell'INBOX

Restituisce informazioni sulla quota di utilizzo della propria INBOX in megabyte.

Authorizations:
bearerAuth
path Parameters
mailbox
required
string
Example: inbox

La casella di posta da controllare. Si può usare 'INBOX' per controllare lo stato della casella di posta principale.

header Parameters
x-username
required
string

Nome utente dell'e-mail da controllare

x-password
required
string

Password dell'e-mail da controllare

Responses

Response Schema: application/json
object (QuotaResponse)
success
boolean
message
string

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.pecmassiva.com/quota/inbox");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-username: SOME_STRING_VALUE");
headers = curl_slist_append(headers, "x-password: SOME_STRING_VALUE");
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": ""
}
Web Service Revision: 2.0.0