Zapier | Quire

Zapier yhdistyy Quireen saman REST API:n, OAuth-asiakkaiden ja webhookien kautta kuin muutkin integraatiot. Kummallakaan puolella ei tarvita Quire-kohtaista koodia, joten Zap voi tehdä kaiken, mitä API-viite tarjoaa.

Käynnistä Zap Quiren tapahtumasta

Valitse Zapierissa käynnistimeksi Webhooks by Zapier ja tapahtumaksi Catch Raw Hook. Valitse raakasisältö, koska allekirjoitus lasketaan Quiren lähettämistä täsmällisistä tavuista. Kopioi Zapierin antama osoite.
Avaa Quiressa /admin/webhooks, valitse Add subscription, liitä osoite ja valitse tapahtumat, esimerkiksi course_completion.changed. Quire lähettää ensin testitapahtuman. Tilaus alkaa, kun Zapier on vastaanottanut sen.
Lisää Code by Zapier -vaihe allekirjoituksen tarkistamiseksi tilauksen salaisuudella kehittäjän oppaan mukaisesti. Keskeytä Zap, jos allekirjoitus ei täsmää.
Jäsennä runko ja jatka tarvitsemillasi vaiheilla.

Tee toimintoja Quiressa Zapista

Käytä toimintona Webhooks by Zapier -sovelluksen Custom Request -vaihtoehtoa tai sovellusvaiheen API Request -toimintoa:

URL: https://acme.quirelms.com/api/v1/..., esimerkiksi /api/v1/enrolments henkilön ilmoittamiseen kurssille.
Headers: Authorization: Bearer qk_live_... sekä vain tätä Zapia varten osoitteessa /admin/integrations/api-keys luotu avain. Lisää myös käynnistimen tunnisteesta muodostettu Idempotency-Key, jotta Zapierin uudelleenajama Zap ei ilmoita samaa henkilöä kurssille kahdesti.
Data: JSON-muodossa API-viitteen mukaisesti.

Jos haluat toimia organisaation sijasta henkilön nimissä, rekisteröi OAuth-asiakas osoitteessa /admin/integrations/oauth-clients Zapierin uudelleenohjausosoitteella ja käytä sitä yksityisessä Zapier-integraatiossa.

Esimerkki: asiakkaan ilmoittaminen kurssille kaupan päätyttyä

Käynnistin: CRM-järjestelmäsi ilmoitus kaupan voittamisesta.
Mukautettu pyyntö PUT /api/v1/users/ext:{customer id} henkilön nimellä ja sähköpostilla: luo käyttäjän tai päivittää hänet, jos hän on jo olemassa.
Mukautettu pyyntö POST /api/v1/enrolments käyttäjän ja kurssin tiedoilla sekä otsakkeella Idempotency-Key: deal-{deal id}.