Make es connecta a Quire mitjançant l’API REST i els webhooks, amb els mòduls HTTP i webhook propis de Make. Tots els recursos de la referència de l’API estan disponibles.
Iniciar un escenari a partir d’un esdeveniment de Quire
- Afegiu el mòdul Webhooks, Custom webhook, com a primer mòdul i copieu-ne l’adreça.
- A Quire, obriu
/admin/webhooks, trieu Afegeix una subscripció, enganxeu l’adreça i seleccioneu els esdeveniments. L’esdeveniment de prova de Quire permet que Make n’aprengui l’estructura del cos: executeu el mòdul una vegada mentre s’envia. - Verifiqueu la signatura abans d’actuar. A la configuració avançada del
webhook, feu passar les capçaleres i, després, comproveu
webhook-signatureamb{webhook-id}.{webhook-timestamp}.{body}i el secret de la subscripció, tal com s’explica a la guia per a desenvolupadors. Afegiu un filtre que aturi l’escenari si la verificació falla.
Cridar Quire des d’un escenari
Utilitzeu el mòdul HTTP, Make a request:
| Camp | Valor |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Mètode | Tal com s’indica a la referència de l’API |
| Capçaleres | Authorization: Bearer qk_live_... i Idempotency-Key per a les escriptures |
| Tipus de cos | Raw, JSON |
| Analitza la resposta | Sí |
Creeu una clau exclusiva per a Make a /admin/integrations/api-keys i
assigneu-li només els àmbits que necessiti l’escenari. Per recórrer les llistes,
continueu mentre page.has_more sigui true i passeu page.next_cursor com a
cursor: el Repeater de Make amb una Set variable que contingui el cursor
ho fa per vosaltres.
Per als escenaris que hagin d’actuar com una persona, registreu un client OAuth
a /admin/integrations/oauth-clients i utilitzeu-hi el mòdul HTTP de Make,
Make an OAuth 2.0 request.
Exemple: resum setmanal de complecions
- Programació: cada dilluns.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - Apliqueu Iterator sobre
datai Aggregator per convertir-ne el resultat en una taula. - Envieu la taula per correu electrònic o publiqueu-la.