n8n

Die Quire-gemeenskapsnodus vir n8n bied ’n aksienodus vir die REST API en ’n sneller-nodus wat ’n werkvloei begin wanneer iets in Quire gebeur. Dit het geen looptydafhanklikhede nie, dus voeg dit niks by jou n8n-instansie behalwe homself nie.

Installeer

Maak in n8n Settings oop, dan Community nodes, kies Install en voer @quire/n8n-node in. Op selfgehuisveste n8n kan jy eerder npm install @quire/n8n-node in die n8n-gebruikerslêergids uitvoer en herbegin.

Koppel

Skep ’n aanmeldbewys. Twee soorte is beskikbaar:

• Quire API Key: Base URL is jou organisasie se adres sonder ’n skuinsstreep agteraan, soos https://acme.quirelms.com. API Key is ’n sleutel wat ’n administrateur by /admin/integrations/api-keys geskep het en met qk_live_ begin. Gee dit net die omvang wat die werkvloei nodig het.
• Quire OAuth2: vir werkvloeie wat as ’n bepaalde persoon moet optree. Registreer ’n OAuth-kliënt by /admin/integrations/oauth-clients met n8n se herleidingsadres (n8n wys dit op die aanmeldbewys), en voer dan die kliënt-ID, geheim en omvang in.

Aksies

Die Quire-nodus dek gebruikers, kursusse, inskrywings, groepe, voltooiings, punte, sertifikate, indienings, vasvra-pogings, programme, bestellings, e-pos en organisasies. Vir elkeen word lys, kry, skep, werk by en skrap aangebied waar die API dit bied, asook opdatering of invoeging volgens eksterne ID — nuttig vir sinkronisering: voer dieselfde werkvloei twee keer uit en niks word gedupliseer nie.

Die bewerkings word uit Quire se OpenAPI-dokument gegenereer, dus stem hulle veld vir veld ooreen met die API-verwysing. Elke bewerking kan ook deur ’n n8n-KI-agent as ’n nutsmiddel gebruik word; die beskrywing kom uit die API-verwysing.

Lyste gee by verstek elke bladsy terug. Skakel Return All af en stel ’n limiet vir groot organisasies.

Sneller

Voeg die Quire Trigger-nodus by, kies die aanmeldbewys en kies die Events: ’n gebeurtenis volgens naam soos enrolment.created, ’n hele area soos course.* of alles. Wanneer jy die werkvloei aktiveer, skep die nodus ’n webhook-intekening in Quire vir n8n se adres; wanneer jy dit deaktiveer, word die intekening verwyder.

Elke aflewering se handtekening word nagegaan voordat die werkvloei loop. ’n Aflewering wat nie bekragtig nie, word met ’n nodusfout laat vaar, sodat ’n vervalste versoek nie jou werkvloei kan begin nie. Die gebeurtenis se data bevat identifiseerders; voeg ná die sneller ’n Quire-nodus by om die volledige rekord te kry.

Voorbeeld: verwelkomingse-pos by inskrywing

1. Quire Trigger op enrolment.created.
2. Quire-nodus, hulpbron Users, bewerking Get, met die gebruiker-ID {{$json.data.user_id}}.
3. Quire-nodus, hulpbron Courses, bewerking Get, met {{$json.data.course_id}}.
4. Jou e-pos- of kletsnodus, met die persoon se naam en kursustitel.

Probleemoplossing

• 401 op elke oproep: die basis-URL en sleutel behoort aan verskillende organisasies, of die sleutel is herroep.
• 403 op een bewerking: die sleutel het nie daardie omvang nie. Voeg dit by by /admin/integrations/api-keys.
• Die sneller loop nooit af nie: n8n se webhook-adres moet vanaf Quire oor HTTPS bereikbaar wees. Kontroleer die intekening se afleweringslog by /admin/webhooks.