n8n

Mae nod cymunedol Quire ar gyfer n8n yn darparu nod gweithredu ar gyfer yr API REST ac yn sbarduno llifoedd gwaith pan fydd rhywbeth yn digwydd yn Quire. Nid oes ganddo ddibyniaethau amser rhedeg, felly nid yw’n ychwanegu dim at eich instans n8n ond ei hun.

Gosod

Yn n8n, agorwch Settings, yna Community nodes, dewiswch Install, a nodwch @quire/n8n-node. Ar n8n hunangynhaliol gallwch redeg yn lle hynny npm install @quire/n8n-node yn ffolder defnyddiwr n8n ac ailgychwyn.

Cysylltu

Crëwch fanylyn cysylltu. Cynigir dau fath:

• Quire API Key: Base URL yw cyfeiriad eich sefydliad heb slaes terfynol, megis https://acme.quirelms.com. API Key yw allwedd a grëwyd gan weinyddwr yn /admin/integrations/api-keys, gan ddechrau ag qk_live_. Rhowch y cwmpasau sydd eu hangen ar y llif gwaith yn unig.
• Quire OAuth2: ar gyfer llifoedd gwaith a ddylai weithredu fel person penodol. Cofrestrwch gleient OAuth yn /admin/integrations/oauth-clients gyda chyfeiriad ailgyfeirio n8n (mae n8n yn ei ddangos wrth greu’r manylyn cysylltu), yna nodwch ID y cleient, cyfrinach a chwmpasau.

Gweithredoedd

Mae nod Quire yn cwmpasu defnyddwyr, cyrsiau, cofrestriadau, grwpiau, cwblhau, graddau, tystysgrifau, cyflwyniadau, ymdrechion cwis, rhaglenni, archebion, e-bost a sefydliadau. Mae pob un yn cynnig rhestru, cael, creu, diweddaru a dileu lle mae’r API’n caniatáu hynny, ac uwchlwytho drwy ID allanol, sef yr hyn rydych ei eisiau ar gyfer cydamseru: rhedwch yr un llif gwaith ddwywaith ac ni chaiff dim ei ddyblygu.

Cynhyrchir y gweithrediadau o ddogfen OpenAPI Quire, felly maent yn cyfateb fesul maes i’r cyfeirnod API. Gellir defnyddio pob gweithrediad hefyd fel offeryn gan asiant AI n8n; daw ei ddisgrifiad o’r cyfeirnod API.

Mae rhestrau’n dychwelyd pob tudalen yn ddiofyn. Diffoddwch Return All a gosodwch derfyn ar gyfer sefydliadau mawr.

Sbardun

Ychwanegwch nod Quire Trigger, dewiswch y manylyn cysylltu, a dewiswch y Events: digwyddiad yn ôl enw megis enrolment.created, ardal gyfan megis course.*, neu bopeth. Pan fyddwch yn actifadu’r llif gwaith, mae’r nod yn creu tanysgrifiad webhook yn Quire ar gyfer cyfeiriad n8n; pan fyddwch yn anactifadu, caiff y tanysgrifiad ei dynnu.

Caiff llofnod pob dosbarthiad ei wirio cyn rhedeg y llif gwaith. Mae dosbarthiad nad yw’n dilysu yn cael ei ollwng gyda gwall nod, felly ni all cais ffug gychwyn eich llif gwaith. Mae data y digwyddiad yn cynnwys dynodwyr; ychwanegwch nod Quire ar ôl y sbardun i nôl y cofnod llawn.

Enghraifft: e-bost croeso wrth gofrestru

1. Quire Trigger ar enrolment.created.
2. Nod Quire, adnodd Users, gweithred Get, gydag ID y defnyddiwr {{$json.data.user_id}}.
3. Nod Quire, adnodd Courses, gweithred Get, gydag ID y cwrs {{$json.data.course_id}}.
4. Eich nod e-bost neu sgwrs, gan ddefnyddio enw’r person a theitl y cwrs.

Datrys problemau

• 401 ar bob galwad: mae’r URL sylfaenol a’r allwedd yn perthyn i sefydliadau gwahanol, neu cafodd yr allwedd ei dirymu.
• 403 ar un gweithred: nid oes gan yr allwedd y cwmpas hwnnw. Ychwanegwch ef yn /admin/integrations/api-keys.
• Nid yw’r sbardun byth yn tanio: rhaid bod modd cyrraedd cyfeiriad webhook n8n o Quire dros HTTPS. Gwiriwch gofnod dosbarthu’r tanysgrifiad yn /admin/webhooks.