Masterconf API

Ce que vous pouvez construire

• Synchroniser les inscriptions avec votre CRM

  Parcourez les inscriptions d’un événement et tenez votre CRM à jour à chaque nouveau participant.

• Afficher vos événements sur votre site

  Listez vos événements avec leurs dates et leurs lieux, et publiez-les sur votre propre site.

• Publier les communications acceptées

  Lisez les communications d’un appel par statut, avec leurs auteurs et leurs thèmes, et publiez votre programme.

Votre premier appel en trois étapes

1. Créer une clé

   Un administrateur crée une clé d’API dans la console, rubrique « Intégrations ». Copiez-la tout de suite : elle n’est affichée qu’une fois.

2. Appeler l’API

   Envoyez la clé dans l’en-tête Authorization: Bearer mcf_…. GET/v1/account indique quelle organisation et quelle clé la requête a utilisées.

   Requête

   curl

   curl -G https://api.masterconf.com/v1/account \
     -H "Authorization: Bearer mcf_your_key"

   JavaScript

   const res = await fetch("https://api.masterconf.com/v1/account", {
     headers: { Authorization: "Bearer mcf_your_key" },
   });
   const data = await res.json();

   Python

   import requests
   
   res = requests.get(
       "https://api.masterconf.com/v1/account",
       headers={"Authorization": "Bearer mcf_your_key"},
   )
   data = res.json()

3. Lister les inscriptions

   Choisissez un événement et listez ses inscriptions avec GET/v1/registrations, de la plus récente à la plus ancienne.

   Requête

   curl

   curl -G https://api.masterconf.com/v1/registrations \
     -H "Authorization: Bearer mcf_your_key" \
     --data-urlencode "event=EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30"

   JavaScript

   const params = new URLSearchParams({
     "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
   });
   
   const res = await fetch(`https://api.masterconf.com/v1/registrations?${params}`, {
     headers: { Authorization: "Bearer mcf_your_key" },
   });
   const data = await res.json();

   Python

   import requests
   
   res = requests.get(
       "https://api.masterconf.com/v1/registrations",
       params={"event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30"},
       headers={"Authorization": "Bearer mcf_your_key"},
   )
   data = res.json()

Ressources

• Compte

  Le compte auquel appartient la clé d’API : votre organisation, et la clé de la requête avec ses droits et son expiration.

• Événements

  Un événement de votre organisation : une conférence, un congrès, un salon… Ses inscriptions, ses appels à communications et ses communications y renvoient par son id.

• Inscriptions

  L’inscription d’un participant à un événement (un participant, un relecteur, un exposant, un sponsor…), avec son billet et sa présence à l’accueil. Ses réponses au formulaire, ses commandes et ses paiements n’en font jamais partie.

• Appels à communications

  Un appel à communications d’un événement : la période pendant laquelle les auteurs soumettent leurs communications, et les thèmes auxquels ils les soumettent.

• Communications

  Une communication soumise à un appel à communications : son titre, son résumé, ses auteurs (noms et affiliations, jamais une adresse e-mail), ses thèmes et ses références de revues vérifiées. Ses évaluations, ses relecteurs et ses notes n’en font jamais partie.

Comprendre les concepts

• AuthentificationComment fonctionnent les clés d’API, quels droits elles portent, comment elles expirent et sont révoquées.
• Gérer les erreursL’objet error, la différence entre son type et son code, et les erreurs à réessayer.
• PaginationComment les listes se paginent avec un curseur, comment les parcourir et comment tenir une copie à jour.
• Développer les réponsesRemplacez l’id d’un objet lié par l’objet lui-même, et incluez les champs que les listes laissent de côté.
• RechercheTrouvez des inscriptions avec un petit langage de requête, et parcourez les résultats.
• VersionsCe qui peut changer au sein de la v1, ce qui ne change jamais, et comment écrire un client qui continue de fonctionner.
• Limites de débitCombien de requêtes une clé peut envoyer, comment lire les en-têtes de limite, et comment ralentir.
• Identifiants de requêteChaque réponse porte un identifiant. Journalisez-le, et communiquez-le quand vous contactez le support.
• Données excluesCe que l’API ne renvoie jamais, volontairement, et pourquoi.