Make si collega a Quire tramite API REST e webhook, con i moduli HTTP e webhook propri di Make. Tutto ciò che è nel riferimento API è disponibile.
Avviare uno scenario da un evento Quire
- Aggiungi il modulo Webhook Webhook personalizzato come primo modulo e copia il suo indirizzo.
- In Quire, apri
/admin/webhooks, scegli Aggiungi sottoscrizione, incolla l’indirizzo e scegli gli eventi. L’evento di prova di Quire consente a Make di apprendere la forma del corpo: esegui il modulo una volta mentre viene inviato. - Verifica la firma prima di agire. Nelle impostazioni avanzate del webhook,
fai passare le intestazioni, poi confronta
webhook-signaturecon{webhook-id}.{webhook-timestamp}.{body}usando il segreto della sottoscrizione, come descritto nella guida per sviluppatori. Aggiungi un filtro che interrompe lo scenario quando il controllo fallisce.
Chiamare Quire da uno scenario
Usa il modulo HTTP Esegui una richiesta:
| Campo | Valore |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Metodo | Come dice il riferimento API |
| Intestazioni | Authorization: Bearer qk_live_..., e Idempotency-Key per le scritture |
| Tipo di corpo | Raw, JSON |
| Analizza risposta | Sì |
Crea una chiave solo per Make in /admin/integrations/api-keys, con i soli
ambiti di cui lo scenario ha bisogno. Per gli elenchi, ripeti finché page.has_more è true,
passando page.next_cursor come cursor: il Ripetitore di Make con una variabile
Imposta variabile che porta il cursore fa questo.
Per scenari che devono agire come una persona, registra un client OAuth in
/admin/integrations/oauth-clients e usa il modulo HTTP di Make Esegui una
richiesta OAuth 2.0 con esso.
Esempio: riepilogo settimanale dei completamenti
- Programmazione: ogni lunedì.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - Iteratore su
data, Aggregatore in una tabella. - Invia la tabella via email o pubblicala.