Zapier

Zapier forbindes med Quire via det samme REST API, de samme OAuth-klienter og webhooks, som alle integrationer bruger. Der er ingen Quire-specifik kode på nogen af siderne, så en Zap kan gøre alt det, API-referencen tilbyder.

Start en Zap, når noget sker i Quire

1. Vælg Webhooks by Zapier som udløser i Zapier med hændelsen Catch Raw Hook. Rå data, fordi signaturen beregnes ud fra præcis de bytes, Quire sendte. Kopiér adressen, Zapier viser dig.
2. Åbn /admin/webhooks i Quire, vælg Add subscription, indsæt adressen, og vælg hændelserne, f.eks. course_completion.changed. Quire sender først en testhændelse; abonnementet starter, når Zapier har modtaget den.
3. Tilføj et trin med Code by Zapier, som verificerer signaturen med abonnementets hemmelighed som vist i udviklervejledningen. Stop Zap’en, hvis kontrollen fejler.
4. Analysér bodyen, og fortsæt med de trin, du har brug for.

Udfør handlinger i Quire fra en Zap

Brug Webhooks by Zapier med handlingen Custom Request eller API Request i et apptrin:

• URL: https://acme.quirelms.com/api/v1/..., f.eks. /api/v1/enrolments for at tilmelde en person.
• Headers: Authorization: Bearer qk_live_... med en nøgle oprettet på /admin/integrations/api-keys kun til denne Zap og en Idempotency-Key, der er bygget ud fra udløserens id, så en Zap, som Zapier afspiller igen, ikke tilmelder samme person to gange.
• Data: JSON som beskrevet i API-referencen.

Hvis en handling skal udføres på vegne af en person i stedet for organisationen, skal du registrere en OAuth-klient på /admin/integrations/oauth-clients med Zapier’s omdirigeringsadresse og bruge den fra en privat Zapier-integration.

Eksempel: tilmeld en kunde, når en handel lukkes

1. Udløser: CRM-systemets »deal won«.
2. Custom request PUT /api/v1/users/ext:{customer id} med personens navn og e-mail: opretter brugeren eller opdaterer vedkommende, hvis brugeren allerede findes.
3. Custom request POST /api/v1/enrolments med brugeren og kurset samt Idempotency-Key: deal-{deal id}.