Ana məzmuna keçin

http in düyünü

http in düyünü, daxil olan HTTP sorğularını (GET, POST, PUT və digərləri) emal edə bilən HTTP son nöqtələri yaratmaq üçün istifadə olunur. Bu düyün, HTTP protokolu vasitəsilə xarici sistemlərlə qarşılıqlı əlaqə üçün giriş nöqtəsidir.

Vacibdir: Bütün təyin edilmiş yollar avtomatik olaraq prefiks alır: /api/admin/workflows/endpoints/.

http in düyününün parametrləri​

IMG2

1. Ad​

Düyünün adını göstərmək üçün sahə.
Ad iş sahəsində görünür və düyünü asanlıqla tanımağa kömək edir.
Boş qoyulsa, düyün http in adlanacaq.

Nümunə:

  • Düyünün adı: ödəmə linki al

2. Metod​

Düyünün emal edəcəyi HTTP metodu. Aşağıdakı variantlar mövcuddur:

  • GET: Məlumat almaq üçün istifadə olunur.
  • POST: Məlumat göndərmək üçün istifadə olunur.
  • PUT: Məlumatı yeniləmək üçün istifadə olunur.
  • DELETE: Məlumatı silmək üçün istifadə olunur.
  • PATCH: Məlumatı qismən yeniləmək üçün istifadə olunur.
  • OPTIONS: API haqqında meta məlumat almaq üçün sorğular üçün istifadə olunur.

Sorğuları emal etmək üçün yolu (son nöqtə) göstərir.

  • Yol / ilə başlayır.
  • Marşrut dəyişənlərini, məsələn: /data/:id daxil edə bilər.

Nümunə:

  • Link: /ödəmə-linki-al
  • Parametrli link: /ödəmə-linki-al/:sifarişId

Giriş mesajının formatı​

Sorğu göstərilən yola seçilmiş metodla daxil olduqda, http in düyünü aşağıdakı xüsusiyyətləri olan msg mesajı yaradır:

  • msg.req: Başlıqlar, parametrlər, bədən və digər məlumatlar daxil olmaqla HTTP sorğusunun obyektini ehtiva edir.
    • msg.req.params: Marşrut parametrləri (məsələn, :id /api/data/:id-də).
    • msg.req.query: GET sorğusunun parametrləri.
    • msg.req.body: Sorğunun bədəni (POST, PUT və PATCH metodları üçün).
  • msg.res: HTTP cavabını idarə etmək üçün obyekt. Adətən müştəriyə cavab göndərmək üçün http response düyününə ötürülür.

İstifadə nümunəsi​

Nümunə 1: GET sorğusunun emalı​

Ssenari: Temperatur məlumatlarının qaytarılması.

Düyün parametrləri:

  • Metod: GET
  • Link: /temperatur

Axın:

[http in] ---> [function] ---> [http response]

function düyününün kodu:

msg.payload = { temperatur: 22.5, vahid: "Celsius" };
return msg;

Nəticə: /api/admin/workflows/endpoints/temperatur-a GET sorğusu göndərən müştəri JSON cavabı alacaq:

{
  "temperatur": 22.5,
  "vahid": "Celsius"
}

Nümunə 2: POST sorğusunun emalı​

Ssenari: Cihazdan məlumatların qəbul edilməsi və saxlanması.

Düyün parametrləri:

  • Metod: POST
  • Link: /data

Axın:

[http in] ---> [function] ---> [http response]

function düyününün kodu:

// Sorğunun bədənindən məlumatları oxumaq
const data = msg.req.body;
msg.payload = { status: "uğurlu", alınanMəlumat: data };
return msg;

Nəticə: Düyün POST sorğusunun bədənindən məlumatları qəbul edəcək və təsdiq cavabı qaytaracaq.

Nümunə 3: Marşrut parametrlərindən istifadə​

Ssenari: Cihazın identifikatoruna görə məlumatların alınması.

Düyün parametrləri:

  • Metod: GET
  • Link: /cihaz/:id

Axın:

[http in] ---> [function] ---> [http response]

function düyününün kodu:

const cihazId = msg.req.params.id;
msg.payload = { cihazId: cihazId, status: "aktiv" };
return msg;

Nəticə:

{
  "cihazId": "123",
  "status": "aktiv"
}