n8n | Quire

Nod komuniti Quire untuk n8n memberikan anda sebuah nod tindakan untuk REST API dan nod pemicu yang memulakan aliran kerja apabila sesuatu berlaku dalam Quire. Ia tiada kebergantungan masa laksana, jadi ia tidak menambah apa-apa kepada instans n8n anda selain dirinya sendiri.

Memasang

Dalam n8n, buka Settings, kemudian Community nodes, pilih Install, dan masukkan @quire/n8n-node. Pada n8n kendiri, anda boleh sebaliknya menjalankan npm install @quire/n8n-node dalam folder pengguna n8n dan memulakan semula.

Bersambung

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.

Cipta satu kelayakan. Dua jenis ditawarkan:

Quire API Key: Base URL ialah alamat organisasi anda tanpa garis miring di hujungnya, seperti https://acme.quirelms.com. API Key ialah kunci yang dicipta oleh pentadbir di /admin/integrations/api-keys, bermula qk_live_. Berikannya hanya skop yang diperlukan oleh aliran kerja tersebut.
Quire OAuth2: untuk aliran kerja yang sepatutnya bertindak sebagai seseorang tertentu. Daftarkan pelanggan OAuth di /admin/integrations/oauth-clients dengan alamat pengalihan n8n (n8n memaparkannya pada kelayakan tersebut), kemudian masukkan ID pelanggan, rahsia dan skop.

Tindakan

Nod Quire merangkumi pengguna, kursus, pendaftaran, kumpulan, penyiakan, gred, sijil, penyerahan, percubaan kuiz, program, pesanan, e-mel dan organisasi. Setiap satu menawarkan senarai, dapat, cipta, kemas kini dan padam di mana API menyediakannya, serta upsert mengikut ID luaran, yang memang anda mahukan untuk satu penyegerakan: jalankan aliran kerja yang sama dua kali dan tiada apa-apa diduplikasikan.

Operasi dijana daripada dokumen OpenAPI Quire, jadi ia sepadan dengan rujukan API, medan demi medan. Setiap operasi juga boleh digunakan sebagai alat oleh ejen AI n8n; huraiannya datang daripada rujukan API.

Senarai mengembalikan setiap halaman secara lalai. Matikan Return All dan tetapkan satu had untuk organisasi yang besar.

Pemicu

Tambah nod Quire Trigger, pilih kelayakan tersebut, dan pilih Peristiwa: satu peristiwa mengikut nama seperti enrolment.created, seluruh bidang seperti course.*, atau segala-galanya. Apabila anda mengaktifkan aliran kerja itu, nod mencipta langganan webhook dalam Quire untuk alamat n8n; apabila anda menyahaktifkannya, langganan itu dibuang.

Tandatangan setiap penghantaran disemak sebelum aliran kerja berjalan. Penghantaran yang tidak sah akan dibuang bersama ralat nod, jadi satu permintaan yang dipalsukan tidak boleh memulakan aliran kerja anda. Peristiwa data membawa pengenal; tambah nod Quire selepas pemicu untuk mendapatkan rekod penuh.

Contoh: e-mel alu-aluan semasa pendaftaran

Quire Trigger pada enrolment.created.
Nod Quire, sumber Users, operasi Get, dengan ID pengguna {{$json.data.user_id}}.
Nod Quire, sumber Courses, operasi Get, dengan {{$json.data.course_id}}.
Nod e-mel atau sembang anda, menggunakan nama orang tersebut dan tajuk kursus.

Penyelesaian masalah

401 pada setiap panggilan: Base URL dan kunci tersebut adalah milik dua organisasi berbeza, atau kunci telah dibatalkan.
403 pada satu operasi: kunci itu tiada skop tersebut. Tambahkannya di /admin/integrations/api-keys.
Pemicu tidak pernah berlaku: alamat webhook n8n mesti boleh dicapai daripada Quire melalui HTTPS. Semak log penghantaran langganan di /admin/webhooks.