n8n | Quire

n8n üçün Quire icma qovşağı REST API üçün əməliyyat qovşağı və Quire-də hadisə baş verəndə iş axınını başladan trigger qovşağı təqdim edir. Onun işləmə asılılıqları yoxdur, yəni n8n instansiyanıza özündən başqa heç nə əlavə etmir.

Quraşdırma

n8n-də Settings, sonra Community nodes bölməsini açın, Install seçin və @quire/n8n-node daxil edin. Öz serverinizdəki n8n-də alternativ olaraq n8n istifadəçi qovluğunda npm install @quire/n8n-node işlədib yenidən başladın.

Qoşulma

Etimadnamə yaradın. İki növ təklif olunur:

Quire API Key: Base URL sonundakı slash olmadan təşkilatınızın ünvanıdır, məsələn, https://acme.quirelms.com. API Key administratorun /admin/integrations/api-keys ünvanında yaratdığı və qk_live_ ilə başlayan açardır. Yalnız iş axınının ehtiyac duyduğu scope-ları verin.
Quire OAuth2: konkret şəxs kimi işləməli olan iş axınları üçündür. n8n-in yönləndirmə ünvanı ilə (n8n onu etimadnamədə göstərir) /admin/integrations/oauth-clients ünvanında OAuth client qeydiyyatdan keçirin, sonra client ID, secret və scope-ları daxil edin.

Əməliyyatlar

Quire qovşağı istifadəçilər, kurslar, qeydiyyatlar, qruplar, tamamlamalar, qiymətlər, sertifikatlar, təhvil verilən işlər, test cəhdləri, proqramlar, sifarişlər, e-poçt və təşkilatları əhatə edir. API-də olduqda hər biri siyahı, əldə etmə, yaratma, yeniləmə və silmə əməliyyatlarını, eləcə də xarici ID-yə görə upsert-i təklif edir. Sinxronizasiya üçün upsert-dən istifadə edin: eyni iş axınını iki dəfə işlətmək heç nəyi təkrarlamır.

Əməliyyatlar Quire-in OpenAPI sənədindən yaradılır, buna görə API arayışındakı sahələrlə tam uyğun gəlir. Hər əməliyyat n8n süni intellekt agenti üçün alət kimi də istifadə edilə bilər; onun təsviri API arayışından götürülür.

Siyahılar standart olaraq bütün səhifələri qaytarır. Böyük təşkilatlarda Return All parametrini söndürün və limit təyin edin.

Trigger

Quire Trigger qovşağı əlavə edin, etimadnaməni seçin və Events bölməsindən hadisə adı (enrolment.created), bütöv sahə (course.*) və ya hamısını seçin. İş axınını aktivləşdirdikdə qovşaq Quire-də n8n ünvanına vebhuk abunəliyi yaradır; deaktiv etdikdə abunəlik silinir.

İş axını başlamazdan əvvəl hər çatdırılmanın imzası yoxlanılır. Təsdiqlənməyən çatdırılma qovşaq xətası ilə atılır, buna görə saxta sorğu iş axınınızı başlada bilməz. Hadisənin data hissəsində identifikatorlar olur; tam qeydi əldə etmək üçün trigger-dən sonra Quire qovşağı əlavə edin.

Nümunə: qeydiyyatda qarşılama e-poçtu

enrolment.created hadisəsində Quire Trigger.
İstifadəçi ID-si {{$json.data.user_id}} ilə Quire qovşağı, resurs Users, əməliyyat Get.
{{$json.data.course_id}} ilə Quire qovşağı, resurs Courses, əməliyyat Get.
Şəxsin adını və kursun başlığını işlədən e-poçt və ya çat qovşağı.

Problemlərin aradan qaldırılması

Hər çağırışda 401: Base URL və açar müxtəlif təşkilatlara aiddir və ya açar ləğv edilib.
Bir əməliyyatda 403: açarda həmin scope yoxdur. /admin/integrations/api-keys ünvanında əlavə edin.
Trigger işləmir: n8n vebhuk ünvanına Quire tərəfindən HTTPS üzərindən çatmaq mümkün olmalıdır. /admin/webhooks ünvanında abunəliyin çatdırılma jurnalını yoxlayın.