{"openapi":"3.0.0","info":{"title":"PEC Massiva 2.0","description":"Ce service propose des appels rest permettant d'envoyer des messages en masse et de vérifier l'état des e-mails de confirmation d'envoi et de réception des receipts.","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"version":"2.0.0"},"servers":[{"url":"https://ws.pecmassiva.com","description":"Serveur de production"},{"url":"https://test.ws.pecmassiva.com","description":"Serveur de test"}],"paths":{"/send/{code}":{"get":{"tags":["PEC"],"description":"Renvoie le statut des e-mails de confirmation de réception et de livraison relatifs à l'envoi, ainsi que le code renvoyé au moment de l'envoi du PEC","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"code","in":"path","description":"Code renvoyé au moment de l'envoi du PEC. Deux formats acceptés, avec des structures de réponse DIFFÉRENTES : un code hérité basé sur la date commençant par « 20 » (par exemple « 2020082610003492 »), ou un identifiant unique de 24 caractères renvoyé lors de l'envoi du PEC.","required":true,"schema":{"type":"string","example":"2020082610003492"}}],"responses":{"200":{"description":"OK. La structure de l'élément dépend du format de code utilisé (voir le paramètre « code ») : les codes hérités de type « 20... » renvoient la structure ResponseStatus (expéditeur/destinataire/données/objet/message) ; un code ObjectId de 24 caractères renvoie quant à lui une structure différente (uid/messageId/expéditeur/destinataire/date/objet/corps/nombre de pièces jointes/viaSubjectOnly, mêmes éléments que readEmailByMessageId).","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ResponseStatus"}},"success":{"type":"boolean"},"message":{"type":"string"}}},"examples":{"legacyDateCode":{"summary":"code commençant par « 20 » (ancien)","value":{"data":[{"sender":"posta-certificata@pecmassiva.com","recipient":"dev-api@pecmassiva.com","data":"Wed, 26 Aug 2020 10:00:35 +0200","object":"ACCETTAZIONE: Invio di prova pec massiva 2020082610003492","message":""},{"sender":"\"Per conto di: dev-api@pecmassiva.com\" ","recipient":"\"dev-api@pecmassiva.com\" ","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"},{"sender":"posta-certificata@pecmassiva.com","recipient":"dev-api@pecmassiva.com","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":""}},"objectIdCode":{"summary":"Code ObjectId de 24 caractères (msgId/threadId renvoyé lors de l'envoi du PEC)","value":{"data":[{"uid":1044,"messageId":"opec21220.20260908160023.1764277.43.1.47@sicurezzapostale.it","sender":"\"Namirial S.p.A.\" <posta-certificata@sicurezzapostale.it>","recipient":"openapi@pecmassiva.com","date":"Tue, 8 Sep 2026 16:00:23 +0200","subject":"ACCETTAZIONE: Invio di prova pec massiva","body":"RICEVUTA DI ACCETTAZIONE\n\n...","attachmentCount":2,"viaSubjectOnly":false}],"success":true,"message":"Operation successful"}}}}}},"400":{"description":"Code manquant ou invalide, échec de l'authentification IMAP ou aucun e-mail correspondant trouvé","content":{"application/json":{"examples":{"missingCode":{"summary":"Code manquant, ou code qui ne commence pas par « 20 » et qui ne comporte pas 24 caractères","value":{"success":false,"message":"Get parameter code is not valid","error":100}},"authFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":120}},"resultEmpty":{"value":{"success":false,"message":"Result empty","error":404}},"notFoundInDb":{"summary":"Code ObjectId introuvable dans pec_submissions","value":{"success":false,"message":"No matching email found in the database","error":404}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":110}}}}},"summary":"Liste de tous les e-mails liés à un envoi donné","security":[{"bearerAuth":[]}]},"delete":{"tags":["PEC"],"description":"Supprimer l'accusé de réception et la confirmation de livraison d'un e-mail envoyé de votre boîte de réception","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"code","in":"path","description":"Code renvoyé lors de l'envoi du PEC","required":true,"schema":{"type":"string","example":"2020082610003492"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"success":true,"message":"Operation successful"}}}},"400":{"description":"Échec de l'authentification IMAP ou code ObjectId introuvable","content":{"application/json":{"examples":{"notFoundInDb":{"summary":"Code ObjectId introuvable dans pec_submissions","value":{"success":false,"message":"No matching email found in the database","error":404}},"authFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":304}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":302}}}},"404":{"description":"Code manquant ou invalide, ou aucune adresse e-mail trouvée sur IMAP","content":{"application/json":{"examples":{"missingCode":{"value":{"success":false,"message":"Delete parameter code is empty","error":300}},"invalidCode":{"value":{"success":false,"message":"Delete parameter code is not valid or empty","error":300}},"notFound":{"value":{"success":false,"message":"Email not found","error":305}}}}}}},"summary":"Supprimer tous les e-mails liés à un envoi donné","security":[{"bearerAuth":[]}]}},"/send":{"post":{"tags":["PEC"],"summary":"Envoyer un PEC au destinataire indiqué","description":"Envoyez un PEC au destinataire et renvoyez le code d'identification de l'envoi, qui permettra d'obtenir les informations contenues dans les e-mails de confirmation de réception et de livraison. <BR>Il peut y avoir un ou plusieurs destinataires : vous pouvez soit spécifier une seule adresse, soit un tableau de destinataires <BR><BR>Remarque : sur le serveur de test, l'objet de l'e-mail effectivement envoyé est suivi du suffixe « --- sandbox --- » — attendez-vous à le voir si vous examinez le corps brut de l'e-mail ou son objet. <br>Pour les tests, utilisez la boîte mail <code>« username » : « testsandboxpecmassiva@pecmassiva.com », « password » : « openapitest »</code> — une ligne d’avertissement en gras indiquant qu’il s’agit d’un envoi test est ajoutée au début du corps du message. <BR><BR>Limite de taille : le corps complet de la requête ne doit pas dépasser <B>20 Mo</B>. Les pièces jointes sont envoyées sous forme encodée en base64 (environ +33 %), la limite réelle pour la somme des pièces jointes est donc <B>d’environ 15 Mo</B>. Les requêtes plus volumineuses sont rejetées avec un code d'erreur HTTP 413 avant d'être traitées.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestSend"},"example":{"recipient":["dev-api@pecmassiva.com"],"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":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="}],"username":"your_pec_username","password":"your_pec_password"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"message_id":{"type":"string"},"sent":{"description":"Le nombre d'e-mails PEC qui ont été envoyés","type":"integer"}}},"example":{"success":true,"sent":1,"message":"","message_id":"2020082610003492"}}}},"400":{"description":"Le paramètre de publication n'est pas valide","content":{"application/json":{"examples":{"missingField":{"summary":"Champ obligatoire manquant","value":{"success":false,"message":"Missing parameters","error":201}},"invalidUsername":{"summary":"Nom d'utilisateur (== expéditeur) non valide ou non autorisé","value":{"success":false,"message":"Il campo 'username' deve appartenere al dominio @pecmassiva.com oppure essere una casella di tipo PECMASSIVA","error":212}},"invalidRecipient":{"summary":"destinataire non valide","value":{"success":false,"message":"The recipient 'x' is not a valid email address","error":219}},"invalidAttachment":{"summary":"Pièce jointe non décodable","value":{"success":false,"message":"The attachment #0 is not a valid file","error":222}}}}}},"401":{"description":"Échec de l'authentification de la boîte aux lettres PEC","content":{"application/json":{"example":{"success":false,"message":"Autenticazione PEC fallita: ...","error":300}}}},"402":{"description":"Crédit insuffisant","content":{"application/json":{"example":{"success":false,"message":"Credito insufficiente","error":205}}}},"403":{"description":"Limite quotidienne dépassée — ce point de terminaison bloque purement et simplement la requête au lieu de la mettre en file d'attente","content":{"application/json":{"example":{"success":false,"message":"Limite giornaliero di 3500 invii superato. La richiesta è stata bloccata.","error":301}}}},"413":{"description":"Charge utile trop volumineuse : le corps de la requête dépasse 20 Mo (environ 15 Mo de pièces jointes, encodées en base64)","content":{"application/json":{"example":{"success":false,"message":"Payload troppo grande: limite server 20MB (circa 15MB di allegati, codificati in base64). Riduci la dimensione degli allegati.","error":302,"data":null}}}}},"security":[{"bearerAuth":[]}]}},"/threads":{"get":{"tags":["PEC Threads"],"summary":"Afficher vos fils de discussion","description":"Affiche la liste des fils de discussion créés par la boîte mail authentifiée (expéditeur = x-username), en commençant par le plus récent. Métadonnées uniquement, sans enrichissement IMAP — ce qui garantit la rapidité de l'interface, quelle que soit la taille ou le nombre de fils de discussion. Pour consulter l'intégralité d'un fil de discussion, utilisez la requête GET /threads/{threadId}.","parameters":[{"name":"x-username","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Index des pages à partir de 0, 25 fils de discussion par page","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":2,"page":0,"n_of_pages":1,"threads":[{"threadId":"6650f1a2b3c4d5e6f7081920","subject":"Invio di prova pec massiva","dateFirst":"2026-08-26 10:00:35"},{"threadId":"6650f1a2b3c4d5e6f7081925","subject":"Un altro invio","dateFirst":"2026-08-25 09:12:01"}]},"success":true,"message":"Operation successful","error":null}}}},"400":{"description":"La page demandée se trouve après la dernière page","content":{"application/json":{"example":{"success":false,"message":"Wrong page number, max 1 pages","error":706}}}},"401":{"description":"En-tête manquant ou échec de l'authentification IMAP","content":{"application/json":{"examples":{"missingHeader":{"value":{"success":false,"message":"Authorization is not valid or empty","error":701}},"imapAuthFailed":{"value":{"success":false,"message":"Connessione IMAP fallita: ...","error":705}}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["PEC Threads"],"summary":"Envoyer un PEC et créer un fil de discussion traçable","description":"Envoie un PEC au(x) destinataire(s) et crée un fil de discussion traçable : le threadId renvoyé (== msgId pour la racine nouvellement créée) peut être utilisé avec GET /threads/{threadId} pour lire l'intégralité du fil de discussion, avec PATCH /threads/{threadId} pour ajouter une réponse, ou avec DELETE /threads/{threadId} pour le supprimer. Si la limite quotidienne de 3 500 envois est dépassée, la requête est mise en file d’attente (statut : en attente) au lieu d’être rejetée. Prend en charge un callback facultatif, appelé une fois l’envoi terminé et réutilisé par la requête PATCH /threads/{threadId} pour les réponses à ce fil de discussion qui n’en spécifient pas. Crée toujours un NOUVEAU fil de discussion indépendant — n’accepte pas d’identifiant dans l’URL (utilisez PATCH /threads/{threadId} pour poursuivre un fil existant). Remarque : sur le serveur de test, l’objet de l’e-mail effectivement envoyé est suivi du suffixe « --- sandbox --- ». <br>Pour les tests, utilisez la boîte mail <code>« username » : « testsandboxpecmassiva@pecmassiva.com », « password » : « openapitest »</code> — une ligne d’avertissement en gras indiquant qu’il s’agit d’un envoi test est ajoutée au début du corps du message. <BR><BR>Limite de taille : le corps complet de la requête ne doit pas dépasser <B>20 Mo</B>. Les pièces jointes sont envoyées en codage base64 (environ +33 %), la limite réelle pour la somme des pièces jointes est donc <B>d’environ 15 Mo</B>. Les requêtes plus volumineuses sont rejetées avec un code d'erreur HTTP 413 avant d'être traitées.","requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RequestSend"},{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}}]},"example":{"recipient":["dev-api@pecmassiva.com"],"subject":"Invio di prova pec massiva","body":"Salve, questa rappresenta una prova di invio, che prevede un <b>corpo in html</b>","username":"your_pec_username","password":"your_pec_password","callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","custom":{"my_order_id":"123456"}}}}}},"responses":{"200":{"description":"OK — le thread a été créé ; il a été envoyé immédiatement ou mis en file d'attente si la limite quotidienne était dépassée","content":{"application/json":{"examples":{"sent":{"summary":"SENT immédiatement (dans le cadre du quota)","value":{"data":{"msgId":"6650f1a2b3c4d5e6f7081920","threadId":"6650f1a2b3c4d5e6f7081920","createdAt":"26/08/2026 10:00:35","sentAt":"26/08/2026 10:00:35","updateAt":"26/08/2026 10:00:35","status":"sent","subject":"Invio di prova pec massiva","sender":"dev-api@pecmassiva.com","recipients":["dev-api@pecmassiva.com"],"body":"Salve, questa rappresenta una prova di invio, che prevede un <b>corpo in html</b>","attachment":[],"callBack":{"url":"https://your_domain.it/your_callback.php","method":"JSON","custom":{"my_order_id":"123456"}}},"success":true,"message":"Operation successful","error":null}},"pending":{"summary":"En attente (limite quotidienne dépassée)","value":{"data":{"msgId":"6650f1a2b3c4d5e6f7081921","threadId":"6650f1a2b3c4d5e6f7081921","status":"pending","sentAt":null},"success":true,"message":"Richiesta accodata (limite quota giornaliera superato)","error":null}}}}}},"400":{"description":"Paramètre invalide ou manquant, callback invalide ou identifiant dans l'URL","content":{"application/json":{"examples":{"missingField":{"value":{"success":false,"message":"Missing parameters","error":201}},"invalidCallback":{"value":{"success":false,"message":"Invalid callback configuration","error":322}},"idInUrl":{"summary":"POST /threads/{threadId} — appel non valide ; utilisez PATCH pour poursuivre un fil de discussion","value":{"success":false,"message":"POST /threads non accetta un id nell'URL: crea sempre un thread nuovo. Per continuare un thread esistente usa PATCH /threads/{threadId}","error":323}}}}}},"401":{"description":"Échec de l'authentification de la boîte aux lettres PEC","content":{"application/json":{"example":{"success":false,"message":"Autenticazione PEC fallita: ...","error":320}}}},"402":{"description":"Crédit insuffisant","content":{"application/json":{"example":{"success":false,"message":"Credito insufficiente","error":205}}}},"413":{"description":"Charge utile trop volumineuse : le corps de la requête dépasse 20 Mo (environ 15 Mo de pièces jointes, encodées en base64)","content":{"application/json":{"example":{"success":false,"message":"Payload troppo grande: limite server 20MB (circa 15MB di allegati, codificati in base64). Riduci la dimensione degli allegati.","error":324,"data":null}}}},"500":{"description":"Échec de l'envoi","content":{"application/json":{"example":{"success":false,"message":"Errore durante l'invio della PEC","error":321}}}}},"security":[{"bearerAuth":[]}]}},"/threads/{threadId}":{"get":{"tags":["PEC Threads"],"summary":"Lire l'intégralité d'une conversation dans un fil de discussion","description":"Renvoie l'intégralité du fil de discussion sous la forme d'une conversation chronologique unique : le message d'origine (ou chaque réponse envoyée ultérieurement via PATCH), fusionné avec les receipts PEC et les véritables réponses présentes dans la boîte aux lettres. Chaque entrée est associée à un indicateur de direction : « out » (message envoyé par ce compte) ou « in » (message reçu). Les entrées encore en file d'attente (non encore envoyées) ne comportent aucune donnée IMAP associée. Chaque entrée indique également le nombre de pièces jointes (attachmentCount) (métadonnées uniquement, pas de contenu — récupérez un message individuel via GET /threads/{threadId}/{msgId} pour télécharger ses pièces jointes).","parameters":[{"name":"x-username","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"description":"Identifiant du fil de discussion, renvoyé par la requête POST /threads","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081920"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6650f1a2b3c4d5e6f7081920","messageCount":4,"conversation":[{"msgId":"6650f1a2b3c4d5e6f7081920","direction":"out","status":"sent","sender":"dev-api@pecmassiva.com","recipient":["dev-api@pecmassiva.com"],"subject":"Invio di prova pec massiva","body":"Salve, questa rappresenta una prova di invio...","date":"2026-08-26 10:00:35","attachmentCount":1},{"msgId":"6650f1a2b3c4d5e6f7081925","direction":"in","status":"received","sender":"posta-certificata@pecmassiva.com","recipient":"dev-api@pecmassiva.com","subject":"ACCETTAZIONE: Invio di prova pec massiva","body":"","date":"Wed, 26 Aug 2026 10:00:35 +0200","attachmentCount":0},{"msgId":"6650f1a2b3c4d5e6f7081921","direction":"out","status":"sent","sender":"dev-api@pecmassiva.com","recipient":["dev-api@pecmassiva.com"],"subject":"Re: Invio di prova pec massiva","body":"Seguito della comunicazione precedente.","date":"2026-08-26 11:15:02","attachmentCount":0},{"msgId":"6650f1a2b3c4d5e6f7081930","direction":"out","status":"pending","sender":"dev-api@pecmassiva.com","recipient":["dev-api@pecmassiva.com"],"subject":"Re: Invio di prova pec massiva","body":"Ultima reply, non ancora spedita: limite giornaliero superato al momento della richiesta, in coda per il prossimo cron.","date":"2026-08-26 12:00:00","attachmentCount":0}]},"success":true,"message":"Operation successful","error":null}}}},"400":{"description":"Identifiant non valide (n'a pas 24 caractères / n'est pas un ObjectId valide)","content":{"application/json":{"example":{"success":false,"message":"Invalid thread id","error":702}}}},"401":{"description":"En-tête manquant ou échec de l'authentification IMAP","content":{"application/json":{"examples":{"missingHeader":{"value":{"success":false,"message":"Authorization is not valid or empty","error":701}},"imapAuthFailed":{"value":{"success":false,"message":"Connessione IMAP fallita: ...","error":705}}}}}},"403":{"description":"La boîte aux lettres « x-username/x-password » ne correspond pas à l'expéditeur de ce fil de discussion.","content":{"application/json":{"example":{"success":false,"message":"La casella con cui ti autentichi non corrisponde al sender del thread","error":704}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"No thread found for this id","error":703}}}}},"security":[{"bearerAuth":[]}]},"patch":{"tags":["PEC Threads"],"summary":"Poursuivre une discussion existante","description":"Envoie un e-mail de suivi sur un fil de discussion existant : même expéditeur/destinataire que le message d'origine, objet préfixé par « Re: » (sans double préfixe), en-têtes In-Reply-To/References pointant vers le Message-ID du message d'origine. Seuls le corps du message (+ les pièces jointes facultatives) et le nom d’utilisateur/mot de passe sont obligatoires — l’expéditeur, le destinataire et l’objet sont repris de la racine du fil de discussion. Suit la même règle de quota quotidien que POST /threads : au-delà de la limite de 3 500 par jour, la réponse est mise en file d’attente au lieu d’être envoyée immédiatement. Le message racine du fil de discussion doit déjà avoir été envoyé (un message racine encore en file d’attente ne peut pas faire l’objet d’une suite). Prend en charge un callback facultatif, appelé lorsque l’envoi est terminé (uniquement pour le cas d’envoi immédiat — le callback d’une réponse mise en file d’attente se déclenche plus tard, lorsque la tâche cron l’envoie effectivement). Si elle est omise, la fonction de rappel par défaut est celle configurée lors de l’appel POST /threads d’origine du fil de discussion, le cas échéant. La même mise en garde concernant le suffixe d’objet « --- sandbox --- » du serveur de test que pour POST /threads s’applique ici également. <br>Pour les tests, utilisez la boîte aux lettres <code>« username » : « testsandboxpecmassiva@pecmassiva.com », « password » : « openapitest »</code> — une ligne d’avertissement en gras indiquant qu’il s’agit d’un envoi test est ajoutée au début du corps de la requête. <BR><BR>Limite de taille : le corps complet de la requête ne doit pas dépasser <B>20 Mo</B>. Les pièces jointes sont envoyées sous forme encodée en base64 (environ +33 %), la limite réelle pour la somme des pièces jointes est donc <B>d’environ 15 Mo</B>. Les requêtes plus volumineuses sont rejetées avec un code d'erreur HTTP 413 avant d'être traitées.","parameters":[{"name":"threadId","in":"path","required":true,"description":"Identifiant du fil de discussion pour continuer","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081920"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body","username","password"],"properties":{"body":{"type":"string"},"attachments":{"$ref":"#/components/schemas/Attachment"},"username":{"type":"string"},"password":{"type":"string"},"callback":{"type":"object","description":"Facultatif. Appelé avec la même charge utile que les données de la réponse 200, une fois l'envoi terminé. S'il est omis, c'est la fonction de rappel propre au thread (provenant de POST /threads) qui est utilisée à la place, le cas échéant."}}},"example":{"body":"Seguito della comunicazione precedente.","username":"your_pec_username","password":"your_pec_password","callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","custom":{"my_order_id":"123456"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"examples":{"sent":{"summary":"SENT immédiatement (dans la limite du quota) — même structure de données que POST /threads","value":{"data":{"msgId":"6650f1a2b3c4d5e6f7081921","threadId":"6650f1a2b3c4d5e6f7081920","createdAt":"26/08/2026 11:15:02","sentAt":"26/08/2026 11:15:02","updateAt":"26/08/2026 11:15:02","status":"sent","subject":"Re: Invio di prova pec massiva","sender":"dev-api@pecmassiva.com","recipients":["dev-api@pecmassiva.com"],"body":"Seguito della comunicazione precedente.","attachment":[],"callBack":{"url":"https://your_domain.it/your_callback.php","method":"JSON","custom":{"my_order_id":"123456"}},"accepted":false,"acceptedAt":null,"deliveries":[]},"success":true,"message":"Operation successful","error":null}},"pending":{"summary":"En attente (limite quotidienne dépassée)","value":{"data":{"msgId":"6650f1a2b3c4d5e6f7081922","threadId":"6650f1a2b3c4d5e6f7081920","status":"pending"},"success":true,"message":"Richiesta accodata (limite quota giornaliera superato)","error":null}}}}}},"400":{"description":"Identifiant, corps ou informations d'authentification manquants ou non valides, ou callback non valide (le callback est facultatif)","content":{"application/json":{"examples":{"body":{"value":{"success":false,"message":"Il campo 'body' non può essere vuoto","error":714}},"invalidCallback":{"value":{"success":false,"message":"Invalid callback configuration","error":731}}}}}},"401":{"description":"Échec de l'authentification de la boîte aux lettres PEC","content":{"application/json":{"example":{"success":false,"message":"Autenticazione PEC fallita: ...","error":716}}}},"402":{"description":"Crédit insuffisant","content":{"application/json":{"example":{"success":false,"message":"Credito insufficiente","error":205}}}},"404":{"description":"Fil de discussion introuvable","content":{"application/json":{"example":{"success":false,"message":"No thread found for this id","error":713}}}},"409":{"description":"La racine du fil de discussion n'a pas encore été envoyée","content":{"application/json":{"example":{"success":false,"message":"Thread not yet sent, cannot continue it","error":712}}}},"413":{"description":"Charge utile trop volumineuse : le corps de la requête dépasse 20 Mo (environ 15 Mo de pièces jointes, encodées en base64)","content":{"application/json":{"example":{"success":false,"message":"Payload troppo grande: limite server 20MB (circa 15MB di allegati, codificati in base64). Riduci la dimensione degli allegati.","error":720,"data":null}}}},"500":{"description":"Échec de l'envoi","content":{"application/json":{"example":{"success":false,"message":"Errore durante l'invio della PEC","error":717}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["PEC Threads"],"summary":"Supprimer un fil de discussion entier","description":"Supprime la racine du fil de discussion et toutes les réponses (enregistrements dans pec_submissions/pec_queue) ; tente, dans la mesure du possible, de supprimer les e-mails correspondants sur IMAP (à la fois dans la boîte de réception et dans le dossier « Posta Inviata » / « SENT ») ; et supprime également tous les messages reçus (receipts et réponses réelles) de ce fil de discussion de la boîte de réception, ainsi que leurs enregistrements pec_inbound_refs. Pour supprimer un seul message plutôt que l'intégralité du fil de discussion, utilisez DELETE /threads/{threadId}/{msgId}.","parameters":[{"name":"x-username","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081920"}}],"responses":{"200":{"description":"OK. La liste supprimée/ignorée contient à la fois les messages du fil de discussion lui-même (message d'origine + réponses, _id interne) et les identifiants de référence internes des messages reçus (pec_inbound_refs) — un identifiant ne figure dans la liste supprimée que si son e-mail a effectivement été supprimé de l'IMAP (ou s'il était encore en file d'attente, sans rien à supprimer).","content":{"application/json":{"example":{"data":{"deleted":["6650f1a2b3c4d5e6f7081920","6650f1a2b3c4d5e6f7081930"],"skipped":[]},"success":true,"message":"Thread deleted","error":null}}}},"400":{"description":"Identifiant manquant ou non valide","content":{"application/json":{"example":{"success":false,"message":"Thread id is required","error":720}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":721}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"No thread found for this id","error":727}}}},"424":{"description":"Aucun message de ce fil de discussion n'a pu être supprimé via IMAP avec ces identifiants (rien n'a été supprimé, pas même partiellement)","content":{"application/json":{"example":{"success":false,"message":"No message of this thread could be deleted on IMAP with these credentials","error":729}}}}},"security":[{"bearerAuth":[]}]}},"/threads/{threadId}/{msgId}":{"get":{"tags":["PEC Threads"],"summary":"Lire un seul message d'un fil de discussion, avec toutes ses pièces jointes","description":"Même format d'entrée qu'un élément de la conversation GET /threads/{threadId}, mais avec le contenu complet de la pièce jointe (base64) au lieu du simple nombre de pièces jointes (attachmentCount). msgId est toujours un identifiant unique de 24 caractères (ObjectId). S’il correspond à un message envoyé ou mis en file d’attente par ce compte (message principal ou réponse), les pièces jointes proviennent de la copie chiffrée stockée dans le compartiment si le message est toujours en file d’attente, ou sont réanalysées à partir de la structure MIME IMAP de la copie « Posta Inviata » si le message a déjà été envoyé. Sinon, il s’agit de la référence interne (pec_inbound_refs) d’un message reçu (receipt ou réponse réelle) — l’uid IMAP réel est déterminé en interne à partir de cette référence, et les pièces jointes sont réanalysées à partir de la structure MIME IMAP correspondante. La propriété du fil de discussion (x-username doit correspondre à l’expéditeur du fil) et la connectivité IMAP sont vérifiées avant de renvoyer quoi que ce soit.","parameters":[{"name":"x-username","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"description":"Identifiant du fil de discussion","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081920"}},{"name":"msgId","in":"path","required":true,"description":"Identifiant unique (ObjectId) du message (message SENT/en attente, ou référence interne pour un message RECEIVED)","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081921"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"msgId":"6650f1a2b3c4d5e6f7081920","direction":"out","status":"sent","sender":"dev-api@pecmassiva.com","recipient":["dev-api@pecmassiva.com"],"subject":"Invio di prova pec massiva","body":"Salve, questa rappresenta una prova di invio...","date":"2026-08-26 10:00:35","attachmentCount":1,"attachments":[{"name":"documento.pdf","mimeType":"application/pdf","size":34821,"content":"JVBERi0xLjQKJ..."}]},"success":true,"message":"Operation successful","error":null}}}},"400":{"description":"Identifiant/msgId non valide","content":{"application/json":{"example":{"success":false,"message":"Invalid message id","error":706}}}},"401":{"description":"En-tête manquant ou échec de l'authentification IMAP","content":{"application/json":{"examples":{"missingHeader":{"value":{"success":false,"message":"Authorization is not valid or empty","error":701}},"imapAuthFailed":{"value":{"success":false,"message":"Connessione IMAP fallita: ...","error":705}}}}}},"403":{"description":"La boîte aux lettres « x-username/x-password » ne correspond pas à l'expéditeur de ce fil de discussion.","content":{"application/json":{"example":{"success":false,"message":"La casella con cui ti autentichi non corrisponde al sender del thread","error":704}}}},"404":{"description":"Fil de discussion ou message introuvable","content":{"application/json":{"examples":{"threadNotFound":{"value":{"success":false,"message":"No thread found for this id","error":703}},"messageNotFound":{"value":{"success":false,"message":"Message not found in this thread","error":707}}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["PEC Threads"],"summary":"Supprimer un seul message dans un fil de discussion","description":"Supprime un message du fil de discussion au lieu du fil entier. msgId est toujours un identifiant unique de 24 caractères (ObjectId). S'il correspond à un message déjà envoyé par ce compte (message initial ou réponse), l'e-mail est d'abord supprimé de l'IMAP — si cela échoue, rien n'est supprimé et l'enregistrement est conservé. S’il est encore en file d’attente (jamais envoyé), seul l’enregistrement est supprimé, sans intervention d’IMAP. Sinon, msgId correspond à la référence interne (pec_inbound_refs) d’un message RECEIVED : celui-ci est d’abord supprimé de la boîte de réception (INBOX), puis son enregistrement de référence — là encore, rien n’est supprimé si la suppression IMAP échoue.","parameters":[{"name":"x-username","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","required":true,"schema":{"type":"string"}},{"name":"threadId","in":"path","required":true,"description":"Identifiant du fil de discussion","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081920"}},{"name":"msgId","in":"path","required":true,"description":"Identifiant unique (ObjectId) du message (message SENT ou référence interne pour un message RECEIVED)","schema":{"type":"string","example":"6650f1a2b3c4d5e6f7081921"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":null,"success":true,"message":"Message deleted","error":null}}}},"400":{"description":"Identifiant ou msgId manquant ou non valide, ou échec de la connexion IMAP ou de la suppression d'un message RECEIVED","content":{"application/json":{"examples":{"invalidId":{"value":{"success":false,"message":"Invalid message id","error":723}},"imapAuthFailed":{"summary":"Message reçu : échec de la connexion IMAP avec ces identifiants","value":{"success":false,"message":"Authorization is not valid or empty","error":725}},"imapDeleteFailed":{"summary":"Message reçu : échec de la commande imap_delete","value":{"success":false,"message":"An error occured","error":726}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":721}}}},"404":{"description":"Message introuvable dans ce fil de discussion","content":{"application/json":{"example":{"success":false,"message":"Message not found in this thread","error":724}}}},"424":{"description":"Message SENT : échec de la suppression via IMAP — l'enregistrement n'a pas été modifié","content":{"application/json":{"example":{"success":false,"message":"Email not found on IMAP with these credentials, record was not deleted","error":728}}}}},"security":[{"bearerAuth":[]}]}},"/inbox/{id}":{"get":{"tags":["Inbox"],"description":"Renvoie un seul message.","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"L'identifiant du message que vous avez reçu via /inbox","required":true,"schema":{"type":"number","example":3}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InboxSingle"},"success":{"type":"boolean"},"message":{"type":"string"}}},"example":{"data":{"sender":"posta-certificata@pecmassiva.com","recipient":"altravia@pecmassiva.com","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":""}}}},"400":{"description":"L'identifiant du message fourni n'est pas numérique, ou l'authentification IMAP a échoué","content":{"application/json":{"examples":{"invalidId":{"value":{"success":false,"message":"The provided message ID is not valid","error":412}},"authFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":420}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":410}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"Message not found","error":415}}}}},"summary":"Renvoie un seul message présent dans la boîte de réception","security":[{"bearerAuth":[]}]},"delete":{"tags":["Inbox"],"description":"Supprimer l'accusé de réception et la confirmation de livraison d'un e-mail SENT de votre boîte de réception","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"L'identifiant du message que vous avez reçu via /inbox","required":true,"schema":{"type":"number","example":3}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"success":true,"message":"Message deleted","data":[]}}}},"400":{"description":"Identifiant manquant ou non valide, ou échec de la suppression","content":{"application/json":{"examples":{"invalidId":{"value":{"success":false,"message":"Get parameter code is not valid or empty","error":520}},"authFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":522}},"deleteFailed":{"value":{"success":false,"message":"An error occured","error":524}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":510}}}}},"summary":"Supprimer un e-mail","security":[{"bearerAuth":[]}]}},"/inbox":{"get":{"tags":["Inbox"],"description":"Renvoie le contenu de votre boîte de réception. Les résultats peuvent être paginés : chaque page contient jusqu'à 25 messages et dispose d'un identifiant unique que vous pourrez utiliser ultérieurement pour récupérer un message en particulier ou le supprimer. <br> De plus, vous pouvez également effectuer des requêtes à l'aide du paramètre « q ».","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Critères de recherche","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page actuelle","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InboxSearch"}},"success":{"type":"boolean"},"message":{"type":"string"},"page":{"type":"number"},"total":{"type":"number"},"n_of_pages":{"type":"number"},"error":{"type":"integer","nullable":true}}},"example":{"data":[{"sender":"posta-certificata@pecmassiva.com","recipient":"dev-api@pecmassiva.com","date":"Wed, 26 Aug 2020 10:00:35 +0200","object":"ACCETTAZIONE: Invio di prova pec massiva 2020082610003492","id":1},{"sender":"\"Per conto di: dev-api@pecmassiva.com\" ","recipient":"\"dev-api@pecmassiva.com\" ","date":"Wed, 26 Aug 2020 10:00:35 +0200","object":"POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492","id":2},{"sender":"posta-certificata@pecmassiva.com","recipient":"dev-api@pecmassiva.com","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,"error":null}}}},"400":{"description":"Échec de la connexion IMAP, ou la page demandée se trouve après la dernière page","content":{"application/json":{"examples":{"imapFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":420}},"searchFailed":{"value":{"success":false,"message":"Fetching mailbox Failed: ...","error":440}},"wrongPage":{"value":{"success":false,"message":"Wrong page number 40: valid range 0-38 (39 pages total)","error":430}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":410}}}}},"summary":"Obtenir la liste des e-mails présents dans votre boîte de réception","security":[{"bearerAuth":[]}]}},"/inbox/unread":{"get":{"tags":["Inbox"],"description":"Renvoie les messages non lus (indicateur IMAP « \\Seen » non activé) présents dans votre boîte de réception, en commençant par les plus récents (c'est-à-dire ceux dont l'UID IMAP est le plus élevé), sans les marquer comme lus. Pour chaque message non lu, tente de déterminer à quel fil de discussion PEC il appartient en inspectant uniquement ses en-têtes (X-Riferimento-Message-ID pour les receipts standard, In-Reply-To/References pour les véritables réponses, et la correspondance de l’objet comme solution de secours moins fiable pour les réponses de PEC à PEC encapsulées dans une enveloppe de transport sans lien Message-ID) — aucun corps de message n’est récupéré, donc cette vérification ne marque jamais rien comme lu. <br>Remarque : un threadId nul ne garantit pas que le message n’est lié à aucun fil de discussion — certaines réponses ne sont identifiables qu’en ouvrant l’intégralité de la conversation du fil (ce qui récupère le corps du message).","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"skip","in":"query","description":"Nombre de messages non lus à ignorer, classés par ordre chronologique décroissant. Valeur par défaut : 0.","required":false,"schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Nombre maximal de messages non lus à renvoyer. À omettre pour n'imposer aucune limite (tous les messages non lus).","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"UID IMAP du message non lu — à utiliser avec GET/DELETE /inbox/{id}"},"threadId":{"type":"string","nullable":true,"description":"Identifiant du fil de discussion /threads correspondant, ou null si aucune correspondance « légère » (en-tête uniquement) n'a été trouvée"},"msgId":{"type":"string","nullable":true,"description":"Même msgId que celui utilisé lors de la lecture ou de l'envoi d'un message dans un fil de discussion. Valeur nulle sauf si le threadId a été résolu et que le message dispose d'un en-tête Message-ID valide."}}}},"count":{"type":"integer","description":"Nombre d'éléments dans les données (cette page)"},"total":{"type":"integer","description":"Nombre total de messages non lus dans la boîte de réception, indépendamment des paramètres « ignorer » et « limite »"},"skip":{"type":"integer"},"limit":{"type":"integer","nullable":true,"description":"Null si aucune limite n'a été demandée"},"hasUnread":{"type":"boolean","description":"Vrai si total > 0"}}},"example":{"data":[{"id":1044,"threadId":"6650f1a2b3c4d5e6f7081920","msgId":"6650f1a2b3c4d5e6f7081925"},{"id":1047,"threadId":null,"msgId":null}],"count":2,"total":2,"skip":0,"limit":null,"hasUnread":true}}}},"400":{"description":"Échec de la connexion IMAP ou de la recherche","content":{"application/json":{"examples":{"imapFailed":{"summary":"Échec de la connexion IMAP avec les identifiants x-username/x-password","value":{"success":false,"message":"Authorization is not valid or empty","error":420}},"searchFailed":{"value":{"success":false,"message":"Fetching mailbox Failed: ...","error":440}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":410}}}}},"summary":"Vérifiez s'il y a des e-mails non lus et, le cas échéant, consultez leur fil de discussion","security":[{"bearerAuth":[]}]}},"/quota":{"get":{"tags":["Inbox"],"description":"Renvoie le nombre de messages PEC envoyés aujourd'hui depuis cette boîte mail par rapport à la limite partagée de 3 500 par jour — comptabilisés en fonction de l'adresse de la boîte mail (en-tête « x-username »). Nécessite une vérification d'authentification IMAP réelle avec « x-username » et « x-password » avant le comptage.","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DailyUsage"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":{"used":120,"limit":3500,"remaining":3380},"success":true,"message":"","error":null}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide, ou l'authentification de la boîte aux lettres PEC a échoué","content":{"application/json":{"examples":{"missingHeaders":{"value":{"success":false,"message":"Authorization is not valid or empty","error":610}},"imapAuthFailed":{"value":{"success":false,"message":"Autenticazione PEC fallita: ...","error":640}}}}}}},"summary":"Renvoie le nombre d'e-mails envoyés aujourd'hui depuis cette boîte mail","security":[{"bearerAuth":[]}]}},"/quota/{mailbox}":{"get":{"tags":["Inbox"],"description":"Renvoie des informations sur le quota d'utilisation de votre boîte de réception en <b>kilo-octets</b> (extension IMAP QUOTA, RFC 2087 — blocs de 1 024 octets), ainsi que le nombre d'e-mails PEC envoyés aujourd'hui (dailyUsage) par rapport à la limite quotidienne partagée.","parameters":[{"name":"x-username","in":"header","description":"Nom d'utilisateur ou adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"x-password","in":"header","description":"Mot de passe de l'adresse e-mail à vérifier","required":true,"schema":{"type":"string"}},{"name":"mailbox","in":"path","description":"La boîte de réception à consulter. Vous pouvez utiliser « INBOX » pour vérifier l'état de votre boîte de réception principale.","required":true,"example":"inbox","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuotaResponse"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":{"usage":171012,"limit":1048576,"dailyUsage":{"used":120,"limit":3500,"remaining":3380}},"success":true,"message":"","error":null}}}},"400":{"description":"Échec de la connexion IMAP, ou boîte aux lettres non valide/indisponible","content":{"application/json":{"examples":{"imapFailed":{"value":{"success":false,"message":"Authorization is not valid or empty","error":620}},"mailboxUnavailable":{"value":{"success":false,"message":"An error occured: the requested mailbox might be unavailable","error":630}}}}}},"401":{"description":"L'autorisation n'est pas valide ou est vide","content":{"application/json":{"example":{"success":false,"message":"Authorization is not valid or empty","error":610}}}},"404":{"description":"Chemin d'accès non valide (segments supplémentaires après /quota/{mailbox})","content":{"application/json":{"example":{"success":false,"message":"Path not valid: use /quota or /quota/{mailbox}","error":650}}}}},"summary":"Affiche le nombre de messages dans votre boîte de réception","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"QuotaResponse":{"type":"object","properties":{"usage":{"type":"number"},"limit":{"type":"number"},"dailyUsage":{"$ref":"#/components/schemas/DailyUsage"}}},"DailyUsage":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"}}},"InboxSingle":{"type":"object","properties":{"sender":{"type":"string"},"recipient":{"type":"string"},"date":{"type":"string"},"object":{"type":"string"},"body":{"type":"string"}}},"InboxSearch":{"type":"object","properties":{"sender":{"type":"string"},"recipient":{"type":"string"},"date":{"type":"string"},"object":{"type":"string"},"id":{"type":"number"}}},"ResponseStatus":{"type":"object","properties":{"sender":{"type":"string"},"recipient":{"type":"string"},"data":{"type":"string"},"object":{"type":"string"},"message":{"type":"string"}}},"Attachment":{"type":"object","description":"Les pièces jointes sont prises en compte dans la limite de 20 Mo imposée pour le corps de la requête : comme elles sont encodées en base64, la taille totale des fichiers d'origine doit rester inférieure à environ 15 Mo.","properties":{"name":{"type":"string"},"file":{"type":"string","format":"base64encode","description":"Contenu du fichier, encodé en Base64"}}},"Callback":{"type":"object","description":"Configuration standardisée des rappels. Permet de recevoir des notifications concernant les mises à jour de statut des requêtes asynchrones.","properties":{"method":{"type":"string","description":"Spécifiez la méthode de rappel. Si la valeur est « POST », une requête HTTP POST standard sera lancée avec le type de contenu « application/x-www-form-urlencoded ». Les données JSON seront encodées sous la forme d'une paire clé-valeur nommée « data » (personnalisable via le paramètre « field »). Lorsque la valeur est définie sur « JSON », une requête HTTP POST directe sera effectuée avec le type de contenu application/json et le corps JSON brut.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","nullable":true,"description":"Fonctionne avec method='POST'. Détermine le nom du paramètre envoyé dans le corps de la requête POST. Valeur nulle lorsque method='JSON' (sans objet).","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"Une URL valide capable de traiter les requêtes POST. Pour les points de terminaison authentifiés, utilisez le paramètre « headers ». Le délai d'expiration maximal est de 30 secondes. Si le paramètre « retry » est défini, le système effectue plusieurs tentatives jusqu'à ce qu'un code d'état 200 soit reçu.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Nombre maximal de tentatives de réessai. Les réessais ne concernent que les erreurs temporaires (par exemple 502, 503) ou les problèmes réseau, avec un délai d'attente exponentiel. La valeur maximale est 5.","example":3,"minimum":0,"maximum":5,"default":0},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"En-têtes HTTP à envoyer avec la requête de rappel. Utile pour l'authentification (authentification de base, authentification « bearer ») ou pour des métadonnées personnalisées.","example":{"session_id":"9834r5fh589494"}},"custom":{"description":"Données supplémentaires à inclure dans la charge utile de la fonction de rappel, accessibles via la clé « custom » du corps de la fonction de rappel. Il peut s'agir de n'importe quelle valeur JSON (objet, tableau, chaîne de caractères, nombre).","example":{"my_custom_id":"123456789"}}}},"RequestSend":{"type":"object","required":["recipient","subject","body","username","password"],"properties":{"recipient":{"description":"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.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"subject":{"type":"string"},"body":{"type":"string"},"attachments":{"$ref":"#/components/schemas/Attachment"},"username":{"type":"string","description":"Également utilisé comme expéditeur (les deux correspondent toujours à la même boîte mail). Doit se terminer par @pecmassiva.com, OU appartenir à une boîte mail REGISTERED avec tipo_casella = PECMASSIVA."},"password":{"type":"string"}}}}},"externalDocs":{"description":"C'est votre première visite ? Générez un nouveau jeton d'accès","url":"https://console.openapi.com/fr/oauth"}}