La solution la plus simple et la plus sûre pour l'envoi de vos REM massives
Gérer et automatiser l'envoi de grandes quantités de messages électroniques certifiés via l'API
L'API REM Massif est disponible en version standard, permettant l'envoi de jusqu'à 3 500 messages par jour au coût de 0,05€ par message individuel. Le service nécessite l'activation d'une boîte REM avec le domaine @pecmassiva.com.
De plus, deux options d'abonnement annuel sont disponibles :
- 365 000 messages par an pour seulement 0,004€ par message
- 1 200 000 messages par an pour seulement 0,002€ par message
Veuillez noter que l'activation de l'abonnement n'inclut pas l'activation de la boîte @pecmassiva.com, qui doit être effectuée séparément.
Pour vérifier la disponibilité de l'adresse PEC souhaitée, une demande doit être faite au endpoint GET /pec.openapi.it/verifica_pec/{pec}.
La demande doit spécifier l'adresse PEC dont la disponibilité doit être vérifiée.
La réponse indique si l'adresse est disponible (si elle est positive, le message est "true", si elle est négative, il est "false").
Une fois que vous avez vérifié la disponibilité de l'adresse REM, vous pouvez procéder à son enregistrement via l'endpoint POST https://pec.openapi.it/pec.
Les données à transmettre dans le corps de la requête sont les suivantes:
- Boîte PEC
- type de boîte
- type et sous-type de client
- informations sur le demandeur (nom et prénom, e-mail et téléphone, code fiscal, date de naissance, sexe, pays et province de naissance)
- nom et code fiscal du détenteur de l'email
- l'adresse complète du titulaire (rue, commune, code postal, pays, province)
- toute url callback définie
Vous pouvez également activer le renouvellement automatique en ajoutant le paramètre facultatif "autorinnovo=auto-renewal" avec la valeur "true" dans le corps du message (actuellement, la valeur par défaut est "false").
La réponse contiendra une série d'informations, notamment un résumé des caractéristiques du REM. Le statut d'activation du REM et l'identifiant sont également spécifiés.
L'identifiant sera essentiel pour les prochaines étapes d'activation, pour vérifier le statut et pour le renouvellement.
Vous pouvez procéder à l'activation du REM via l'endpoint PATCH /pec/{id}/attivazione.
Pour effectuer cette opération, vous devez télécharger le formulaire requis (GET /pec/{id}/modulo_attivazione) et procéder à l'envoi du formulaire, correctement rempli et signé, accompagné de l'identifiant du demandeur. Il doit s'agir d'un document unique au format PDF.
L'identifiant est celui obtenu dans l'endpoint précédent (POST /pec.openapi.it/pec).
Oui, vous pouvez vérifier l'état de votre REM à tout moment via l'endpoint GET /pec/{id} et à partir de la valeur de l'identifiant de la REM.
La réponse fournit de nombreuses informations. Tout d'abord, le statut de la PEC (par exemple, enregistré) et ensuite d'autres informations telles que:
- le propriétaire de la REM
- le domaine
- la date d'enregistrement
- l'espace de stockage disponible
- toute url de rappel définie
VEUILLEZ NOTER: Actuellement, la vérification n'est possible que pour les clients qui se sont activés via API et non via www.pecmassiva.com. Cette endpoint n'est pas valide pour vérifier le statut de la REM Massif FLAT.
Il est possible d'envoyer un message certifié via l'API au moyen du endpoint POST /send.
Les destinataires peuvent être uniques ou multiples et les paramètres de départ sont les suivants:
- expéditeur (sender)
- destinataire
- objet
- corps du message (message)
- pièces jointes (nom et fichier de la pièce jointe)
- nom d'utilisateur de la PEC
- password de la PEC
La réponse renvoie le code d'identification de l'envoi (message id), qui sera utile ultérieurement pour les courriels de réception et de confirmation de livraison.
VEUILLEZ NOTER: cette endpoint peut traiter jusqu'à 1 requête/seconde.
Oui, il est possible de consulter l'état des courriels reçus et de vérifier leur livraison, via l'endpoint GET /send/{code}.
Les paramètres de départ sont les suivants
- nom d'utilisateur de l'e-mail à vérifier
- password de l'e-mail à vérifier
- code renvoyé lors de l'envoi du PEC (identifiant du message)
La réponse fournit des informations sur
- l'expéditeur
- le destinataire
- la date d'envoi
- l'objet
- le corps du message (message)
Oui, il est possible de le faire via le point de terminaison DELETE /send/{code}.
Les paramètres de départ sont les suivants
- nom d'utilisateur de l'e-mail à vérifier
- password de l'e-mail à vérifier
- code renvoyé lors de l'envoi du PEC (identifiant du message)
La réponse indiquera si l'opération a réussi avec les messages suivants:
- 'Operation successfull' si positif
- ‘Authorization in not valid or empty’ en cas de réponse négative
Oui, l'endpoint GET /inbox renvoie le contenu de votre boîte de réception à partir des paramètres suivants
- le nom d'utilisateur de l'email à vérifier (obligatoire)
- de l'email à vérifier (obligatoire)
- q - critères de recherche (facultatif)
- page - page actuelle (facultatif)
Le paramètre q permet de rechercher des messages dans la inbox. Les résultats peuvent être paginés et chaque page contient jusqu'à 25 messages.
La réponse fournit des informations sur
- l'expéditeur (sender)
- le destinataire (recipient)
- la date d'envoi
- l'objet
- l'identifiant
L'identifiant unique peut être utilisé ultérieurement pour obtenir le message individuel ou le supprimer.
Oui, il est possible d'afficher des messages individuels dans la boîte de réception via l'endpoint GET /inbox/{id}.
Les paramètres de départ sont les suivants
- nom d'utilisateur de l'e-mail à vérifier
- mot de passe de l'e-mail à vérifier
- id du message reçu de la boîte de réception
La réponse fournit des informations sur
- l'expéditeur
- le destinataire
- la date d'envoi
- l'objet
- le corps du message (message)
Oui, vous pouvez le faire via le point de terminaison DELETE /inbox/{id}.
Les paramètres de départ sont les suivants
- nom d'utilisateur de l'e-mail à vérifier
- mot de passe de l'e-mail à vérifier
- id du message reçu de la boîte de réception
La réponse indique si l'opération a réussi avec les messages suivants:
- ‘Message deleted’ dans le cas positif
- ‘Authorization in not valid or empty’ dans le cas négatif
Oui, vous pouvez être informé du quota d'utilisation (en mégaoctets) de votre boîte de réception.
Les paramètres de départ sont les suivants
- le nom d'utilisateur de l'e-mail à vérifier
- mot de passe de l'e-mail à vérifier
- boîte aux lettres: la boîte aux lettres à vérifier. On peut utiliser 'inbox' pour vérifier l'état de la boîte aux lettres principale.
La réponse fournit des informations sur
- le quota d'utilisation
- les limites de taille totale de la boîte de réception
Le délai d'activation de REM Massif est de 24 heures.
L'API REM Massiva est disponible en version standard avec jusqu'à 3 500 messages envoyés par jour. Elle comprend l'activation d'une boîte REM avec le domaine @pecmassiva.com et un coût de 0,05€ par message envoyé.
Cependant, deux solutions d'abonnement annuel sont également disponibles :
- 365 000 messages par an pour seulement 0,004€ par message
- 1 200 000 messages par an pour seulement 0,002€ par message
Pour le REM Massive Standard, le coût est de 0,05€ par message individuel, tandis qu'avec l'abonnement, il est possible d'envoyer un message à partir de 0,002€.
Dans la section Utilisation, au niveau de l'API, vous pouvez contrôler vos demandes gratuites et vos demandes de recharge. Ces données sont disponibles sous forme de graphique (période, mois et année) et de résumé textuel.