n8n

Tha nòid coimhearsnachd Quire airson n8n a’ toirt nòid gnìomh dhut airson an API REST agus nòid brosnachaidh a thòisicheas sruth-obrach nuair a thachras rudeigin ann an Quire. Chan eil eisimeileachd aig àm-ruith aige, agus mar sin cha chuir e dad ri eisimpleir n8n ach e fhèin.

Stàlaich

Ann an n8n, fosgail Roghainnean, agus an uair sin Nòdan coimhearsnachd; tagh Stàlaich agus cuir a-steach @quire/n8n-node. Air n8n fèin-aoigheachd faodaidh tu npm install @quire/n8n-node a ruith ann am pasgan cleachdaiche n8n an àite sin agus ath-thòiseachadh.

Ceangail

Cruthaich teisteanas. Tha dà sheòrsa ann:

• Iuchair API Quire: ’s e URL bunaiteach seòladh na buidhne agad gun t-slash aig an deireadh, mar https://acme.quirelms.com. ’S e Iuchair API iuchair a chruthaich rianaire aig /admin/integrations/api-keys, a thòisicheas le qk_live_. Na toir dhi ach na raointean a dh’fheumas an sruth-obrach.
• Quire OAuth2: airson sruthan-obrach a bu chòir obrachadh às leth neach sònraichte. Clàraich cliant OAuth aig /admin/integrations/oauth-clients leis an t-seòladh ath-sheòlaidh aig n8n (seallaidh n8n e air an teisteanas), agus an uair sin cuir a-steach ID a’ chliant, an dìomhaireachd agus na raointean.

Gnìomhan

Tha an nòid Quire a’ còmhdach luchd-cleachdaidh, cùrsaichean, clàraidhean, buidhnean, crìochnachaidhean, ìrean, teisteanasan, tagraidhean, oidhirpean cheasnachaidhean, prògraman, òrdughan, post-d agus buidhnean. Tha gach goireas a’ tabhann liosta, faighinn, cruthachadh, ùrachadh agus sguabadh às far a bheil an API a’ ceadachadh sin, agus cur ris no ùrachadh leis an ID a-muigh. ’S e seo an dòigh a tha thu ag iarraidh airson sioncronachadh: ruith an aon sruth-obrach dà thuras agus cha bhi dùblaidhean ann.

Tha na h-obraichean air an cruthachadh bhon sgrìobhainn OpenAPI aig Quire, agus mar sin tha iad a’ maidseadh nan raointean san iomradh API. Faodar gach obrachadh a chleachdadh cuideachd mar inneal le àidseant AI n8n; tha an tuairisgeul aige a’ tighinn bhon iomradh API.

Bidh liostaichean a’ tilleadh gach duilleag mar bhun-roghainn. Cuir dheth Till na h-uile agus suidhich crìoch airson buidhnean mòra.

Brosnaiche

Cuir nòid Brosnaiche Quire ris, tagh an teisteanas agus na Tachartasan: tachartas a rèir ainm mar enrolment.created, raon slàn mar course.*, no gach tachartas. Nuair a chuireas tu an sruth-obrach an gnìomh, cruthaichidh an nòid fo-sgrìobhadh webhook ann an Quire gu seòladh n8n; nuair a chuireas tu dheth e, thèid an fho-sgrìobhadh a thoirt air falbh.

Thèid ainm-sgrìobhte gach lìbhrigidh a sgrùdadh mus tòisich an sruth-obrach. Thèid lìbhrigeadh nach dearbhaich a leigeil seachad le mearachd nòid, agus mar sin chan urrainn do dh’iarrtas foill sruth-obrach a thòiseachadh. Tha aithnichearan ann an data an tachartais; cuir nòid Quire às a dhèidh gus an clàr slàn fhaighinn.

Eisimpleir: post-d fàilte nuair a chlàras cuideigin

1. Nòid Brosnaiche Quire airson enrolment.created.
2. Nòid Quire, goireas Luchd-cleachdaidh, obrachadh Faigh, leis an ID cleachdaiche {{$json.data.user_id}}.
3. Nòid Quire, goireas Cùrsaichean, obrachadh Faigh, leis an ID cùrsa {{$json.data.course_id}}.
4. Nòid post-d no cabadaich agad, a’ cleachdadh ainm an neach agus tiotal a’ chùrsa.

Fuasgladh dhuilgheadasan

• 401 air gach gairm: buinidh an URL bunaiteach agus an iuchair do dhiofar bhuidhnean, no chaidh an iuchair a chùl-ghairm.
• 403 air aon obrachadh: chan eil an raon riatanach aig an iuchair. Cuir ris e aig /admin/integrations/api-keys.
• Cha tig am brosnachadh a-riamh: feumaidh seòladh webhook n8n a bhith ruigsinneach do Quire tro HTTPS. Thoir sùil air log lìbhrigidh an fho-sgrìobhaidh aig /admin/webhooks.