Make se connecte à Quire via l’API REST et les webhooks, à l’aide de ses propres modules HTTP et Webhook. Tout ce que décrit la référence de l’API est accessible.
Lancer un scénario depuis un événement Quire
- Ajoutez le module Webhooks, option Webhook personnalisé, comme premier module, puis copiez son adresse.
- Dans Quire, ouvrez
/admin/webhooks, choisissez Ajouter un abonnement, collez l’adresse et sélectionnez les événements. L’événement de test de Quire permet à Make de découvrir la structure du corps : exécutez le module une fois pendant son envoi. - Vérifiez la signature avant toute action. Dans les paramètres avancés du webhook, transmettez les en-têtes, puis vérifiez
webhook-signatureà l’aide de{webhook-id}.{webhook-timestamp}.{body}et du secret de l’abonnement, conformément au guide du développeur. Ajoutez un filtre qui arrête le scénario si la vérification échoue.
Appeler Quire depuis un scénario
Utilisez le module HTTP, action Effectuer une requête :
| Champ | Valeur |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Méthode | Selon les indications de la référence de l’API |
| En-têtes | Authorization: Bearer qk_live_... et Idempotency-Key pour les écritures |
| Type de corps | Brut, JSON |
| Analyser la réponse | Oui |
Créez une clé réservée à Make dans /admin/integrations/api-keys, avec uniquement les portées nécessaires au scénario. Pour parcourir une liste, continuez tant que page.has_more vaut true et transmettez page.next_cursor en tant que cursor : le Répéteur de Make accompagné d’une Définition de variable contenant le curseur permet de le faire.
Pour les scénarios qui doivent agir au nom d’une personne, enregistrez un client OAuth dans /admin/integrations/oauth-clients et utilisez-le avec le module HTTP, action Effectuer une requête OAuth 2.0.
Exemple : récapitulatif hebdomadaire des achèvements
- Planification : chaque lundi.
- HTTP :
GET /api/v1/course_completions?updated_since=<a week ago>. - Itérateur sur
data, puis Agrégateur dans un tableau. - Envoyez le tableau par e-mail ou publiez-le.