Make se connecte à Quire au moyen de l’API REST et des webhooks, avec ses propres modules HTTP et webhook. Tout ce que propose la référence de l’API est disponible.
Lancer un scénario à partir d’un événement Quire
- Ajoutez le module Webhooks et Custom webhook comme premier module, puis copiez son adresse.
- Dans Quire, ouvrez
/admin/webhooks, choisissez Add subscription, collez l’adresse et choisissez les événements. L’événement de test de Quire permet à Make d’apprendre la structure du corps : exécutez le module une fois pendant son envoi. - Vérifiez la signature avant d’agir. Dans les paramètres avancés du webhook, faites passer les en-têtes, puis comparez
webhook-signatureà{webhook-id}.{webhook-timestamp}.{body}avec le secret de l’abonnement, comme le décrit le 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 Make a request :
| Champ | Valeur |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Method | Comme indiqué dans la référence de l’API |
| Headers | Authorization: Bearer qk_live_... et Idempotency-Key pour les écritures |
| Body type | Raw, JSON |
| Parse response | Oui |
Créez une clé réservée à Make dans /admin/integrations/api-keys, avec seulement les portées nécessaires au scénario. Pour les listes, bouclez tant que page.has_more est vrai en transmettant page.next_cursor comme cursor : le Repeater de Make avec un Set variable qui conserve le cursor fait l’affaire.
Pour les scénarios qui doivent agir au nom d’une personne, enregistrez un client OAuth dans /admin/integrations/oauth-clients et utilisez le module HTTP de Make, action Make an OAuth 2.0 request.
Exemple : résumé hebdomadaire des achèvements
- Schedule : chaque lundi.
- HTTP :
GET /api/v1/course_completions?updated_since=<a week ago>. - Iterator sur
data, puis Aggregator pour créer un tableau. - Envoyez le tableau par courriel ou publiez-le.