Aller au contenu
Docs

Référence

Journal des modifications : Clés API

Clés API : nouvelles fonctionnalités, améliorations et corrections.

octobre 2026

  1. Nouveauté

    Suivi des événements : événements d’espace de travail et événements personnalisés

    Suivi des événementsClés APIWebhooks

    Vous pouvez désormais envoyer vos propres événements à côté de ceux qu’Emailit enregistre, comme une commande, un changement de forfait ou la consultation d’un produit. Ils se gèrent dans les nouveaux onglets Workspace events et Tracking de Email API > Events.

    • Deux portées. Les événements d’espace de travail (w:<name>) sont déclarés au préalable avec des propriétés typées, et Emailit rejette les événements qui ne correspondent pas. Les événements personnalisés (c:<name>) acceptent n’importe quel objet JSON. Le journal des événements dispose d’un filtre Scope, et l’endpoint Lister les événements d’un paramètre scope.
    • Depuis vos serveurs. Envoyer un événement enregistre un événement, et Envoyer des événements par lot jusqu’à 100. Ces endpoints fonctionnent avec les nouvelles clés API Events Only, qui peuvent envoyer des événements, mais ni lire de données ni envoyer d’e-mails.
    • Depuis votre site web. Le script de suivi envoie des événements avec une clé de suivi publique que vous pouvez limiter à vos propres sites. identify rattache les événements d’un visiteur à un contact.
    • Contacts et webhooks. Les événements apparaissent dans l’Activity log du contact. Les webhooks reçoivent les types que vous choisissez, ou tous les événements d’espace de travail ou personnalisés avec w:* et c:*.
    • API et MCP. Les API des événements d’espace de travail et des clés de suivi, ainsi que l’outil send-event et les outils d’événements d’espace de travail du groupe d’outils MCP events.
    • Forfaits. Le suivi des événements et le script de suivi sont inclus dans les forfaits Pro, Business et Custom. Pro peut utiliser 100 types d’événements, Business 1 000, et Custom n’a pas de limite. Consultez Limites.

    Consultez Suivi des événements.

septembre 2026

  1. Correction

    Corrections de compatibilité de l’API v2

    API RESTClés APIAPI e-mailDomaines d’envoi

    • Les clés API créées avant l’introduction du préfixe secret_ sont de nouveau acceptées sur /v2.
    • Récupérer un e-mail renvoie l’objet e-mail complet, y compris object, from et to.
    • Les réponses des domaines renvoient track_loads et track_clicks sous la forme 0 ou 1, comme documenté.
  2. Modification

    Les clés API d’envoi uniquement sont limitées aux endpoints d’envoi

    Clés APIAPI e-mail

    Les clés d’envoi uniquement pouvaient auparavant lister et récupérer des e-mails et appeler certains autres endpoints de lecture. Elles sont désormais limitées à Envoyer un e-mail et aux actions sur un e-mail existant : reprogrammer, annuler, relancer et transférer. Les autres endpoints rejettent les clés d’envoi.

    Si votre intégration lit aussi des e-mails, des domaines ou d’autres ressources, utilisez une clé à accès complet pour ces appels. Consultez Clés API.

octobre 2025

  1. Nouveauté

    API v2

    API RESTClés APIDomaines d’envoiListes de contactsAdresses bloquées

    Les clés API remplacent les identifiants. Une clé a la portée full ou sending, une clé d’envoi peut être restreinte à un seul domaine d’envoi, et vous pouvez gérer les clés via l’API. L’API v1 est restée disponible pendant votre migration.

    Consultez la référence de l’API.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.