Zapier

Zapier kobler seg til Quire gjennom det samme REST-API-et, OAuth-klientene og webhookene som alle integrasjoner bruker. Det finnes ingen Quire-spesifikk kode på noen av sidene, så alt API-referansen tilbyr, kan en Zap gjøre.

Start en Zap når noe skjer i Quire

1. I Zapier velger du Webhooks by Zapier som utløser, med hendelsen Catch Raw Hook. Rå, fordi signaturen beregnes over nøyaktig de bytene Quire sendte. Kopier adressen Zapier gir deg.
2. I Quire åpner du /admin/webhooks, velger Add subscription, limer inn adressen og velger hendelsene, for eksempel course_completion.changed. Quire sender først en testhendelse; abonnementet starter når Zapier har mottatt den.
3. Legg til et Code by Zapier-trinn som verifiserer signaturen med abonnementshemmeligheten, som vist i utviklerveiledningen. Stopp Zap-en når den ikke verifiseres.
4. Tolk kroppen og fortsett med trinnene du trenger.

Handle i Quire fra en Zap

Bruk Webhooks by Zapier med handlingen Custom Request, eller API Request i et app-trinn:

• URL: https://acme.quirelms.com/api/v1/..., for eksempel /api/v1/enrolments for å melde på noen.
• Headers: Authorization: Bearer qk_live_... med en nøkkel laget på /admin/integrations/api-keys kun for denne Zap-en, og en Idempotency-Key bygget fra utløserens ID, slik at en Zap som Zapier spiller av på nytt ikke melder på samme person to ganger.
• Data: JSON, slik API-referansen beskriver.

For å handle som en person i stedet for som organisasjonen, registrer en OAuth-klient på /admin/integrations/oauth-clients med Zapiers omdirigeringsadresse og bruk den fra en privat Zapier-integrasjon.

Eksempel: meld på en kunde når en avtale lukkes

1. Utløser: CRM-ets «deal won».
2. Egendefinert forespørsel PUT /api/v1/users/ext:{customer id} med personens navn og e-post: oppretter brukeren, eller oppdaterer vedkommende hvis den finnes.
3. Egendefinert forespørsel POST /api/v1/enrolments med brukeren og kurset, og Idempotency-Key: deal-{deal id}.