Nouveaux points de terminaison API : Contacts, Événements et Webhooks
Nous venons de déployer trois nouveaux groupes de ressources dans l’API Emailit v2. Il s’agit des Contacts, Événements et Webhooks. Ensemble, ils vous donnent un contrôle programmatique complet sur votre carnet d’adresses, la surveillance des événements et les intégrations webhook.
Contacts
L’API Contacts vous permet de créer, consulter, modifier et supprimer des contacts dans votre espace de travail. Chaque contact contient une adresse e-mail, un nom optionnel et des champs personnalisés, et peut être abonné à une ou plusieurs audiences en un seul appel.
| Point de terminaison | Description |
|---|---|
| Lister les Contacts | Liste paginée de tous les contacts |
| Obtenir un Contact | Récupérer un contact par ID ou e-mail |
| Créer un Contact | Créer un nouveau contact et l’abonner à des audiences |
| Modifier un Contact | Modifier le nom, l’e-mail, les champs personnalisés ou le statut de désabonnement |
| Supprimer un Contact | Supprimer un contact et tous les abonnés associés |
Les contacts peuvent être recherchés par leur ID (con_xxx) ou par adresse e-mail, vous pouvez donc utiliser l’identifiant qui vous convient le mieux.
{
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}Événements
Les événements sont créés automatiquement chaque fois que quelque chose se produit dans votre espace de travail. Par exemple, un e-mail est livré, un contact est créé, un domaine est mis à jour, etc. L’API Événements vous donne un accès en lecture seule à ce flux d’activité.
| Point de terminaison | Description |
|---|---|
| Lister les Événements | Liste paginée avec filtrage par type et charge utile de données optionnelle |
| Obtenir un Événement | Récupérer un événement unique avec toutes les données |
Vous pouvez filtrer par un ou plusieurs types d’événements en utilisant des valeurs séparées par des virgules, et activer include_data pour contrôler si la charge utile complète est retournée dans les réponses de liste.
GET /v2/events?type=email.accepted,email.delivered&include_data=trueWebhooks
Les webhooks vous permettent de recevoir des rappels HTTP en temps réel chaque fois que des événements se produisent. La nouvelle API Webhooks vous donne un contrôle complet. Vous pouvez créer, modifier, activer/désactiver et supprimer des points de terminaison webhook, le tout via l’API.
| Point de terminaison | Description |
|---|---|
| Lister les Webhooks | Liste paginée de tous les webhooks |
| Obtenir un Webhook | Récupérer un webhook par ID |
| Créer un Webhook | Créer un nouveau point de terminaison webhook |
| Modifier un Webhook | Modifier l’URL, les événements ou le statut d’activation |
| Supprimer un Webhook | Supprimer un webhook par ID ou nom |
Vous pouvez vous abonner à des types d’événements spécifiques ou utiliser all_events pour tout recevoir.
{
"name": "Webhook de Production",
"url": "https://example.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}Il existe plus de 30 types d’événements disponibles couvrant les e-mails, domaines, audiences, abonnés, contacts, modèles, suppressions et vérifications d’e-mails. Consultez la liste complète dans la documentation Créer un Webhook.
Pour commencer
Les trois API nécessitent une clé API avec permissions complètes. Rendez-vous dans la Référence API pour explorer tous les nouveaux points de terminaison, ou consultez directement la documentation liée ci-dessus.
Blog
Les dernières actualités et mises à jour, directement depuis Emailit.
Restez informé des derniers articles du Blog Emailit.
