Zapier | Quire

Zapier se připojuje k Quire přes stejné REST API, klienty OAuth a webhooky jako ostatní integrace. Ani jedna strana nepotřebuje kód specifický pro Quire, takže Zap dokáže vše, co nabízí referenční dokumentace API.

Spuštění Zapu při události v Quire

V Zapieru zvolte jako spouštěč Webhooks by Zapier s událostí Catch Raw Hook. Zvolte Raw, protože podpis se počítá z přesných bajtů odeslaných Quire. Zkopírujte adresu, kterou vám Zapier poskytne.
V Quire otevřete /admin/webhooks, zvolte Add subscription, vložte adresu a vyberte události, například course_completion.changed. Quire nejprve odešle testovací událost; předplatné začne po jejím přijetí Zapierem.
Přidejte krok Code by Zapier, který ověří podpis pomocí tajného klíče předplatného podle příručky pro vývojáře. Pokud ověření selže, Zap zastavte.
Zpracujte tělo požadavku a pokračujte potřebnými kroky.

Provedení akce v Quire ze Zapu

Použijte Webhooks by Zapier s akcí Custom Request nebo API Request v kroku aplikace:

URL: https://acme.quirelms.com/api/v1/..., například /api/v1/enrolments pro zápis uživatele.
Headers: Authorization: Bearer qk_live_... s klíčem vytvořeným na /admin/integrations/api-keys pouze pro tento Zap a Idempotency-Key vytvořeným z ID spouštěcí události. Pokud Zapier Zap zopakuje, stejný člověk se tak nezapíše dvakrát.
Data: JSON podle popisu v referenční dokumentaci API.

Chcete-li jednat jménem uživatele, nikoli organizace, zaregistrujte klienta OAuth na /admin/integrations/oauth-clients s přesměrovací adresou Zapieru a použijte ho v soukromé integraci Zapieru.

Příklad: zápis zákazníka po uzavření obchodu

Spouštěč: „deal won“ v CRM.
Vlastní požadavek PUT /api/v1/users/ext:{customer id} se jménem a e-mailem: uživatele vytvoří, nebo aktualizuje, pokud už existuje.
Vlastní požadavek POST /api/v1/enrolments s uživatelem a kurzem a Idempotency-Key: deal-{deal id}.