Die einfachste und sicherste Lösung für den Versand Ihrer Massen-REMs
Verwalten und automatisieren Sie den Versand großer Mengen zertifizierter elektronischer Post über API
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.
Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.
- Oas file url https://console.openapi.com/oas/de/pecmassiva.openapi.json
- Fork or import with Postman
- Production domain ws.pecmassiva.com
- Sandbox domain test.ws.pecmassiva.com
- Production Scopes 6
-
Sandbox Scopes 6
- GET test.ws.pecmassiva.com/send
- POST test.ws.pecmassiva.com/send
- GET test.ws.pecmassiva.com/inbox
- DELETE test.ws.pecmassiva.com/inbox
- GET test.ws.pecmassiva.com/quota
- DELETE test.ws.pecmassiva.com/send
PEC Massiva 1.0 (1.0.0)
Dieser Service bietet Ruheanrufe, um massive Pecs zu senden und den Status der Zustellungs- und Empfangsbestätigungs-E-Mails zu überprüfen
Liste aller E-Mails, die sich auf eine bestimmte Sendung beziehen
Gibt den Status der Empfangs- und Zustellungsbestätigungs-E-Mails in Bezug auf den Versand mit dem Code zurück, der zum Zeitpunkt des Versands der PEC zurückgegeben wurde
Authorizations:
path Parameters
code required | string Example: 2020082610003492 Beim Senden der PEC zurückgegebener Code |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Response Schema: application/json
Array of objects (ResponseStatus) | |
success | boolean |
message | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 401
- 404
- "data": [
- {
- "data": "Wed, 26 Aug 2020 10:00:35 +0200",
- "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
- "message": ""
- {
- "data": "Wed, 26 Aug 2020 10:00:35 +0200",
- "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
- "message": "Salve, questa email � una prova di invio, che prevede un corpo in html"
- {
- "data": "Wed, 26 Aug 2020 10:00:36 +0200",
- "object": "CONSEGNA: Invio di prova pec massiva 2020082610003492",
- "message": "Salve, questa email � una prova di invio, che prevede un corpo in html"
- "success": true,
- "message": ""
Löschen aller E-Mails, die sich auf eine bestimmte Sendung beziehen
Löschen Sie den Empfang und die Zustellbestätigung einer gesendeten E-Mail aus Ihrer INBOX
Authorizations:
path Parameters
code required | string Example: 2020082610003492 Beim Senden der PEC zurückgegebener Code |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 401
- 404
- "success": true,
- "message": "Operation succefull"
Senden einer PEC an den Empfänger gesendet
Senden Sie eine PEC an den gesendeten Empfänger und geben Sie den Identifikationscode der Sendung zurück, der verwendet werden kann, um die Informationen auf den Empfangsbestätigungs- und Zustellungs-E-Mails zurückzugeben.
Empfänger können einer oder viele sein: Sie können entweder eine einzelne Adresse oder ein Array von Empfängern angeben
Bitte beachten Sie, dass dieser Endpunkt bis zu 1 Anfrage/Sekunde verarbeiten kann.
Authorizations:
Request Body schema: application/json
sender | string |
string or Array of strings Senden Sie eine E-Mail an einen oder mehrere Empfänger. Dieses Feld akzeptiert entweder eine Zeichenkette oder ein Array von Zeichenketten. | |
subject | string |
body | string |
object (Attachment) | |
username | string |
password | string |
Responses
Response Schema: application/json
success | boolean |
message | string |
message_id | string |
sent | integer Die Anzahl der gesendeten PEC-E-Mails |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "subject": "Invio di prova pec massiva",
- "body": "Salve, questa rappresenta una prova di invio, che prevede un <b>corpo in html</b>",
- "attachments": [
- {
- "name": "allegato1.png",
- "file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyZpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNMEgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTQgKFdpbmRvd3MpIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOjQ1RTFGMzU5NzA3RTExRTdBRjRFRTc2MUNCMDFEREIzIiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOjQ1RTFGMzVBNzA3RTExRTdBRjRFRTc2MUNCMDFEREIzIj4gPHhtcE1NOkRlcml2ZWRGcm9tIHN0UmVmOml......"
- "username": "your_pec_username",
- "password": "your_pec_password"
Response samples
- 201
- 400
- 401
- 500
- "success": true,
- "sent": 1,
- "message": "",
- "message_id": "2020082610003492"
Gibt eine einzelne Nachricht in der INBOX zurück
Gibt eine einzelne Nachricht zurück. Bitte beachten Sie, dass der Body eine in x-www-form-urlencoded kodierte Zeichenkette ist
Authorizations:
path Parameters
id required | number Example: 3 Die ID der Nachricht, die Sie von /inbox erhalten haben |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Response Schema: application/json
object (InboxSingle) | |
success | boolean |
message | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 401
- 404
- "data": {
- "date": "Mon, 21 Sep 2020 15:26:37 +0200",
- "object": "ACCETTAZIONE: Invio di prova pec massiva 202009211526363",
- "body": "This is an example body."
- "success": true,
- "message": ""
Eine E-Mail löschen
Löschen Sie den Empfang und die Zustellbestätigung einer gesendeten E-Mail aus Ihrer INBOX
Authorizations:
path Parameters
id required | number Example: 3 Die ID der Nachricht, die Sie von /inbox erhalten haben |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 401
- "success": true,
- "message": "Message deleted"
Erhalten Sie eine Liste von E-Mails in Ihrem Posteingang
Gibt den Inhalt Ihrer INBOX zurück. Die Ergebnisse können paginiert werden: jede Seite enthält bis zu 25 Nachrichten und hat eine eindeutige ID, die Sie später verwenden können, um die einzelne Nachricht zu erhalten oder sie zu löschen.
Zusätzlich können Sie auch mit dem Parameter 'q' abfragen. Bitte beachten Sie, dass die Suche in einem stark gefüllten Postfach langsam sein kann.
Authorizations:
query Parameters
q | string Suchkriterien |
page | number Aktuelle Seite |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Response Schema: application/json
Array of objects (InboxSearch) | |
success | boolean |
message | string |
page | number |
total | number |
n_of_pages | number |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 401
- "data": [
- {
- "date": "Wed, 26 Aug 2020 10:00:35 +0200",
- "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
- "id": 1
- {
- "date": "Wed, 26 Aug 2020 10:00:35 +0200",
- "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
- "id": 2
- {
- "date": "Wed, 26 Aug 2020 10:00:36 +0200",
- "object": "CONSEGNA: Invio di prova pec massiva 2020082610003492",
- "id": 3
- "success": true,
- "message": "",
- "total": 981,
- "page": 39,
- "n_of_pages": 39
Gibt die Verwendung Ihrer INBOX zurück
Liefert Informationen über die Nutzungsquote Ihrer INBOX in Megabyte
Authorizations:
path Parameters
mailbox required | string Example: inbox Die zu prüfende Mailbox. Sie können "INBOX" verwenden, um den Status Ihres Hauptpostfachs zu überprüfen |
header Parameters
x-username required | string Benutzername der zu prüfenden E-Mail |
x-password required | string Passwort der zu prüfenden E-Mail |
Responses
Response Schema: application/json
object (QuotaResponse) | |
success | boolean |
message | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 400
- 401
- "data": {
- "usage": 171012,
- "limit": 1048576
- "success": true,
- "message": ""