n8n | Quire

Quire-hnútur samfélagsins fyrir n8n gefur þér aðgerðahnút fyrir REST API og kveikjuhnút sem ræsir verkflæði þegar eitthvað gerist í Quire. Hann hefur engin keyrslutímaaðhengi og bætir því engu öðru við n8n-uppsetninguna þína.

Setja upp

Í n8n skaltu opna Settings, síðan Community nodes, velja Install og slá inn @quire/n8n-node. Í sjálfhýstri n8n-uppsetningu geturðu í staðinn keyrt npm install @quire/n8n-node í notendamöppu n8n og endurræst hana.

Tengjast

Búðu til auðkenni. Boðið er upp á tvær tegundir:

Quire API Key: Base URL er heimilisfang stofnunarinnar þinnar án skástriks aftast, til dæmis https://acme.quirelms.com. API Key er lykill sem stjórnandi bjó til á /admin/integrations/api-keys og byrjar á qk_live_. Veittu honum aðeins þau heimildasvið sem verkflæðið þarf.
Quire OAuth2: fyrir verkflæði sem eiga að framkvæma aðgerðir sem ákveðinn einstaklingur. Skráðu OAuth-biðlara á /admin/integrations/oauth-clients með tilvísunarslóð n8n (n8n sýnir hana á auðkenninu) og sláðu síðan inn biðlaraauðkenni, leyndarmál og heimildasvið.

Aðgerðir

Quire-hnúturinn nær yfir notendur, námskeið, skráningar, hópa, námslok, einkunnir, skírteini, verkefnaskil, próftilraunir, námsleiðir, pantanir, tölvupóst og stofnanir. Fyrir hvert úrræði eru aðgerðirnar list, get, create, update og delete í boði þar sem API styður þær, ásamt upsert eftir ytra auðkenni. Það hentar best fyrir samstillingu: keyrirðu sama verkflæði tvisvar verður ekkert tvítekið.

Aðgerðirnar eru búnar til úr OpenAPI-skjalinu frá Quire og samsvara því API- tilvísuninni reit fyrir reit. Hverja aðgerð má einnig nota sem verkfæri fyrir gervigreindarfulltrúa n8n; lýsing hennar kemur úr API-tilvísuninni.

Listar skila sjálfgefið öllum síðum. Slökktu á Return All og stilltu mörk ef stofnunin er stór.

Kveikja

Bættu við Quire Trigger-hnútnum, veldu auðkennið og veldu Events: atburð eftir heiti eins og enrolment.created, heilt svæði eins og course.* eða alla atburði. Þegar verkflæðið er virkjað stofnar hnúturinn vefkróksáskrift í Quire á slóð n8n; þegar það er óvirkjað er áskriftin fjarlægð.

Undirskrift hverrar sendingar er sannreynd áður en verkflæðið keyrir. Sendingu sem stenst ekki sannprófun er hent með hnútavillu svo fölsuð beiðni geti ekki ræst verkflæðið. data atburðarins inniheldur auðkenni; bættu Quire-hnúti á eftir kveikjunni til að sækja alla færsluna.

Dæmi: velkominn tölvupóstur við skráningu

Quire Trigger á enrolment.created.
Quire-hnútur, úrræði Users, aðgerð Get, með notandaauðkennið {{$json.data.user_id}}.
Quire-hnútur, úrræði Courses, aðgerð Get, með {{$json.data.course_id}}.
Tölvupósts- eða spjallhnúturinn þinn notar nafn viðkomandi og heiti námskeiðs.

Úrræðaleit

401 við hvert kall: grunnslóðin og lykillinn tilheyra ekki sömu stofnun eða lykillinn hefur verið afturkallaður.
403 við eina aðgerð: lykilinn skortir viðeigandi heimildasvið. Bættu því við á /admin/integrations/api-keys.
Kveikjan fer aldrei af stað: vefkróksslóð n8n verður að vera aðgengileg frá Quire yfir HTTPS. Athugaðu afhendingarskrá áskriftarinnar á /admin/webhooks.