n8n | Quire

De Quire-mienskipnode foar n8n jout dy in aksjeknooppunt foar de REST API en in triggerknooppunt dat in wurkstream begjint as der wat bart yn Quire. De node hat gjin ôfhinklikheden by it draaien en foeget dus neat oars as himsels ta oan dyn n8n-ynstallaasje.

Ynstallearje

Iepenje yn n8n Ynstellingen, dêrnei Mienskipsknooppunten, kies Ynstallearje en fier @quire/n8n-node yn. By in selsbehearde n8n kinst ynstee npm install @quire/n8n-node útfiere yn de brûkersmap fan n8n en opnij starte.

Ferbine

The API keys page with a key named for an n8n automation. — Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.

Meitsje in bewiis oan. Der binne twa soarten:

Quire API Key: Basis-URL is it adres fan dyn organisaasje sûnder efterôfgeande slash, lykas https://acme.quirelms.com. API-kaai is in kaai dy’t in behearder oanmakke hat op /admin/integrations/api-keys en begjint mei qk_live_. Jou him allinnich de scopes dy’t de wurkstream nedich hat.
Quire OAuth2: foar wurkstreamen dy’t as in beskate persoan hannelje moatte. Registrearje in OAuth-client op /admin/integrations/oauth-clients mei it trochferwizingadres fan n8n (n8n lit dit by it bewiis sjen), en fier de client-ID, it geheim en de scopes yn.

Aksjes

De node Quire wurket mei brûkers, kursussen, ynskriuwingen, groepen, foltôging, sifers, sertifikaten, ynstjoeringen, kwisbesykjen, programma’s, oarders, e-mail en organisaasjes. Foar elke boarne biedt er list, ophelje, oanmeitsje, bywurkje en wiskje dêr’t de API dat stipet, en ek bywurkje op eksterne ID; dat is geskikt foar in syngronisaasje: itselde proses twa kear útfiere makket neat dûbel.

De operaasjes wurde oanmakke út it OpenAPI-dokumint fan Quire, dus se komme fjild foar fjild oerien mei de API-referinsje. Elke operaasje kin ek as ark troch in n8n AI-agent brûkt wurde; de beskriuwing komt út de API-referinsje.

Standert jouwe listen alle siden werom. Skeakelje Alles weromjaan út en set in limyt yn foar grutte organisaasjes.

Trigger

Foegje it knooppunt Quire Trigger ta, kies it bewiis en selektearje de Barrens: ien barren op namme lykas enrolment.created, in hiel gebiet lykas course.* of alles. As de wurkstream aktivearre wurdt, makket de node yn Quire in webhook-abonnemint foar it adres fan n8n; as de wurkstream deaktivearre wurdt, wurdt dat abonnemint fuorthelle.

De hantekening fan elke levering wurdt kontrolearre foardat de wurkstream begjint. In levering dy’t net ferifiearre wurdt, wurdt wegere mei in nodeflater, sadat in ferfalske fersyk dyn wurkstream net starte kin. De data fan it barren befettet identifiers; foegje nei de trigger in Quire-node ta om it folsleine record op te heljen.

Foarbyld: wolkomstmail by ynskriuwing

Quire Trigger op enrolment.created.
Quire-node, boarne Brûkers, operaasje Ophelje, mei de brûker-ID {{$json.data.user_id}}.
Quire-node, boarne Kursussen, operaasje Ophelje, mei {{$json.data.course_id}}.
Dyn e-mail- of petearknooppunt, mei de namme fan de persoan en de kursustitel.

Problemen oplosse

401 by elke oprop: de basis-URL en kaai hearre by ferskillende organisaasjes, of de kaai is ynlutsen.
403 by ien operaasje: de kaai hat dy scope net. Foegje him ta op /admin/integrations/api-keys.
De trigger giet nea ôf: it webhook-adres fan n8n moat foar Quire fia HTTPS te berikken wêze. Kontrolearje it leveringslogboek fan it abonnemint op /admin/webhooks.