Démarrage rapide

L'API d'intégration permet à votre propre backend d'inscrire ou d'enregistrer vos propres utilisateurs finaux dans un cours ou un webinaire MailInApp, et d'intégrer l'expérience de visionnage/participation dans votre application — sans que cet utilisateur final ne touche jamais à un compte du tableau de bord MailInApp. Elle partage la même clé API porteuse que l'API d'envoi transactionnel — aucun nouvel identifiant à créer.

Créer une clé

La même clé que partout ailleurs : sous Développeurs dans le tableau de bord, cliquez sur Créer une clé. La clé complète — mia_live_... — n'est affichée qu'une seule fois ; MailInApp ne conserve qu'un hachage. Une clé peut appeler chaque route de votre compte, y compris celles ci-dessous.

Inscrire un participant à un webinaire

Inscrit un utilisateur final à un webinaire à inscription publique et renvoie un lien de participation — aucun formulaire MailInApp, aucun compte MailInApp pour votre utilisateur :

curl -X POST https://mailinapp.com/api/v1/webinars/<liveSessionId>/register \
  -H "Authorization: Bearer mia_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "Ada Lovelace"
  }'

Un appel réussi renvoie soit un lien de participation confirmé, soit un statut de liste d'attente :

{ "status": "confirmed", "joinUrl": "https://mailinapp.com/webinar/.../join?token=..." }

Créez le webinaire lui-même de la même façon — POST /api/v1/webinars — ou réutilisez-en un que vous avez déjà créé depuis En direct dans le tableau de bord ; dans les deux cas, il doit être en accessMode: "registration". Voir la référence de l'API pour les formats complets de requête/réponse.

Inscrire un abonné à un cours

Accorde (ou révoque) l'accès à un cours pour une adresse email — votre propre système de facturation ou de paiement décide qui y a droit, MailInApp se contente de rendre le cours :

curl -X POST https://mailinapp.com/api/v1/courses/<courseId>/enroll \
  -H "Authorization: Bearer mia_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "active": true
  }'

{ "subscriberId": "abc123", "active": true }

Intégrer le lecteur de cours

Une fois qu'un abonné est inscrit, créez un jeton signé à courte durée de vie (5 minutes) et redirigez l'iframe ou la fenêtre de votre application vers l'URL renvoyée :

curl -X POST https://mailinapp.com/api/v1/courses/<courseId>/embed-token \
  -H "Authorization: Bearer mia_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'

{ "portalUrl": "https://mailinapp.com/learn/<slug>/courses/<courseId>/embed?token=..." }

Ouvrir portalUrl connecte le visiteur à une page d'amorçage qui échange le jeton et l'amène dans le même portail de cours — vidéo, progression, quiz — qu'obtient un abonné directement inscrit. Le cours doit être published et le compte doit déjà avoir réclamé un slug d'adhésion (/learn/<slug>) pour que cela réussisse.

Le véritable élément différenciateur : les emails de cycle de vie interactifs

Les emails d'inscription, de rappel, d'adhésion et de complétion sont tous toujours envoyés — par défaut, avec le texte de confirmation simple d'aujourd'hui. Depuis le propre panneau de paramètres du cours ou du webinaire dans le tableau de bord, une nouvelle section Emails de cycle de vie vous permet de faire pointer n'importe lequel de ces événements vers un projet que vous avez construit dans le studio à la place. L'email envoyé se rend alors via le moteur de repli complet (blocs cinétiques, balises de fusion, vue en direct) plutôt que via une chaîne codée en dur. Rien ne change pour un événement que vous laissez sans liaison.

Prochaines étapes

Formats complets de requête/réponse, événements de liaison de cycle de vie, limites de fréquence et codes d'erreur : Référence de l'API.
Aucun cours ou webinaire existant à inscrire/enregistrer ? Créez-en un depuis Cours ou En direct dans le tableau de bord d'abord — l'API d'intégration enveloppe les mêmes données sous-jacentes, elle ne crée pas de catalogue séparé.
Les envois transactionnels libres ou de projet studio passent toujours par l'API d'envoi — l'API d'intégration est spécifiquement destinée à l'inscription et à l'intégration de cours/webinaires.