PEC Massif

  1. Home
  2. Bibliothèque d'API
  3. PEC Massif
La solution la plus simple et la plus sûre pour l'envoi de vos PEC massifs

Gérer et automatiser l'envoi de grandes quantités de messages électroniques certifiés via l'API

Toutes les connaissances dont vous avez besoin

Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.

Conseils utiles pour commencer PEC Massif

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.
En savoir plus sur l'API oauth Gérer mes jetons
API docs by Redocly

PEC Massiva 1.0 (1.0.0)

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

Ce service propose des appels au repos pour envoyer des pecs massifs et vérifier le statut des e-mails de livraison et de confirmation de réception.

Vous venez pour la première fois ? Générer un nouveau jeton d'accès

PEC

Liste de tous les e-mails se rapportant à un envoi spécifique

Renvoie le statut des e-mails de réception et de confirmation de livraison en ce qui concerne l'envoi avec le code renvoyé au moment de l'envoi du PEC

Authorizations:
bearerAuth
path Parameters
code
required
string
Example: 2020082610003492

Code renvoyé lors de l'envoi du PEC

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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": ""
}

Suppression de tous les e-mails se rapportant à un envoi spécifique

Supprimez de votre INBOX la réception et la confirmation de livraison d'un e-mail envoyé.

Authorizations:
bearerAuth
path Parameters
code
required
string
Example: 2020082610003492

Code renvoyé lors de l'envoi du PEC

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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"
}

Envoi d'un PEC au destinataire envoyé

Envoyez un PEC au destinataire envoyé et renvoyez le code d'identification de l'envoi, qui peut être utilisé pour renvoyer les informations sur les e-mails d'accusé de réception et de livraison.
Les destinataires peuvent être un ou plusieurs : vous pouvez indiquer soit une adresse unique, soit un tableau de destinataires

Notez que ce point final peut traiter jusqu'à 1 requête/seconde.

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

Envoyer un e-mail à un ou plusieurs destinataires. Ce champ accepte soit une chaîne de caractères, soit un tableau de chaînes de caractères.

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

Responses

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

Le nombre d'e-mails PEC envoyés

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

Renvoie un seul message dans l'INBOX

Renvoie un seul message. Veuillez noter que le corps est une chaîne de caractères codée en x-www-form-urlencoded

Authorizations:
bearerAuth
path Parameters
id
required
number
Example: 3

L'ID du message que vous avez reçu de /inbox

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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": ""
}

Supprimer un e-mail

Supprimez de votre INBOX la réception et la confirmation de livraison d'un e-mail envoyé.

Authorizations:
bearerAuth
path Parameters
id
required
number
Example: 3

L'ID du message que vous avez reçu de /inbox

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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"
}

Obtenir une liste des e-mails dans votre boîte de réception

Renvoie le contenu de votre INBOX. Les résultats peuvent être paginés : chaque page contient jusqu'à 25 messages et possède un identifiant unique que vous pourrez utiliser ultérieurement pour obtenir ou supprimer le message individuel.
En outre, vous pouvez également effectuer une recherche avec le paramètre 'q'. Veuillez noter que la recherche peut être lente dans une boîte aux lettres très remplie.

Authorizations:
bearerAuth
query Parameters
q
string

Critères de recherche

page
number

Page actuelle

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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
}

Renvoie l'utilisation de votre INBOX

Fournit des informations sur le taux d'utilisation de votre INBOX en mégaoctets.

Authorizations:
bearerAuth
path Parameters
mailbox
required
string
Example: inbox

La boîte aux lettres à vérifier. Vous pouvez utiliser "INBOX" pour vérifier l'état de votre boîte aux lettres principale.

header Parameters
x-username
required
string

Nom d'utilisateur de l'e-mail à vérifier

x-password
required
string

Mot de passe de l'e-mail à vérifier

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