n8n

La komunuma nodo de Quire por n8n provizas agan nodon por la REST-API kaj ekigilan nodon, kiu komencas laborfluon kiam io okazas en Quire. Ĝi ne havas rultempajn dependecojn, do ĝi aldonas nenion al via n8n-instanco krom si mem.

Instali

En n8n, malfermu Agordojn, poste Komunumaj nodoj, elektu Instali kaj enigu @quire/n8n-node. Ĉe memgastigata n8n, vi povas anstataŭe ruli npm install @quire/n8n-node en la uzantdosierujo de n8n kaj rekomenci ĝin.

Konekti

Kreu legitimilon. Du tipoj estas ofertataj:

• Quire API-ŝlosilo: Baza URL estas la adreso de via organizaĵo sen fina oblikvo, ekzemple https://acme.quirelms.com. API-ŝlosilo estas ŝlosilo kreita de administranto ĉe /admin/integrations/api-keys, komenciĝanta per qk_live_. Donu al ĝi nur la ampleksojn bezonatajn de la laborfluo.
• Quire OAuth2: por laborfluoj agantaj kiel specifa persono. Registru OAuth-klienton ĉe /admin/integrations/oauth-clients kun la alidirekta adreso de n8n (montrata ĉe la legitimilo), poste enigu la klientan ID, sekreton kaj ampleksojn.

Agoj

La nodo Quire kovras uzantojn, kursojn, aliĝojn, grupojn, kompletigojn, notojn, atestilojn, senditajn laborojn, kvizprovojn, programojn, mendojn, retpoŝton kaj organizaĵojn. Ĉiu rimedo ofertas listigon, legadon, kreadon, ĝisdatigon kaj forigon kie la API tion permesas, kaj alĝustigon laŭ ekstera ID — tion vi bezonas por sinkronigo: rulu la saman laborfluon dufoje kaj nenio duobliĝas.

Operacioj estas generitaj el la OpenAPI-dokumento de Quire, do ili kongruas kampon post kampo kun la API-referenco. Ĉiu operacio ankaŭ uzeblas kiel ilo de n8n-AI-agento; ĝia priskribo venas de la API-referenco.

Listoj defaŭlte redonas ĉiujn paĝojn. Malŝaltu Redoni ĉion kaj agordu limon por grandaj organizaĵoj.

Ekigilo

Aldonu la nodon Quire Trigger, elektu legitimilon kaj elektu la Eventojn: unu eventon laŭ nomo kiel enrolment.created, tutan areon kiel course.* aŭ ĉion. Aktivigante laborfluon, la nodo kreas webhook-abonon en Quire al la adreso de n8n; malaktivigante ĝin, la abono estas forigita.

La subskribo de ĉiu livero estas kontrolata antaŭ ol la laborfluo ruliĝas. Livero kiu ne validas estas forĵetata kun noda eraro, do falsa peto ne povas komenci vian laborfluon. data de la evento enhavas identigilojn; aldonu Quire-nodon post la ekigilo por preni la plenan registron.

Ekzemplo: bonveniga retpoŝto post aliĝo

1. Quire Trigger ĉe enrolment.created.
2. Nodo Quire, rimedo Uzantoj, operacio Legi, kun la uzant-ID {{$json.data.user_id}}.
3. Nodo Quire, rimedo Kursoj, operacio Legi, kun {{$json.data.course_id}}.
4. Via retpoŝta aŭ babila nodo uzante la nomon de la persono kaj la titolon de kurso.

Solvado de problemoj

• 401 ĉe ĉiu voko: la Baza URL kaj ŝlosilo apartenas al malsamaj organizaĵoj aŭ la ŝlosilo estis revokita.
• 403 ĉe unu operacio: al la ŝlosilo mankas tiu amplekso. Aldonu ĝin ĉe /admin/integrations/api-keys.
• La ekigilo neniam funkcias: la webhook-adreso de n8n devas esti atingebla de Quire per HTTPS. Kontrolu la liverprotokolon de la abono ĉe /admin/webhooks.