HTTP sorğusu düyünü

HTTP sorğusu düyünü xarici veb xidmətlərə və ya API-lərə HTTP sorğuları icra etmək üçün nəzərdə tutulmuşdur. O, bir çox HTTP metodlarını, məlumat növlərini, autentifikasiyanı və sorğuların və cavabların çevik idarə edilməsini dəstəkləyir.

HTTP sorğusu düyününün parametrləri

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 request adlanacaq.

Nümunə:

Düyünün adı: Hava Məlumatını Al

2. Metod

Sorğu üçün istifadə olunacaq HTTP metodu. Metodun seçimi icra olunması lazım olan əməliyyatın növündən asılıdır.

Mövcud metodlar:

GET: Məlumatların alınması.
POST: Məlumatların göndərilməsi.
PUT: Məlumatların yenilənməsi.
DELETE: Məlumatların silinməsi.
PATCH: Məlumatların qismən yenilənməsi.
HEAD: Cavab başlıqlarının alınması.
OPTIONS: API haqqında məlumatın alınması.

Nümunə:

Metod: POST

3. Bağlantı

Sorğunun göndəriləcəyi statik URL ünvanını göstərmək üçün sahə.
Əgər ünvan dinamik olaraq təyin olunmalıdırsa, onu msg.url-a ötürmək olar.

Nümunə:

Bağlantı: https://api.example.com/data

4. Məlumat

Giriş məlumatlarının HTTP sorğusuna necə əlavə olunacağını müəyyən edir. Aşağıdakı variantlar mövcuddur:

Yox say:
Giriş məlumatları sorğuda istifadə olunmayacaq. msg.payload sahəsi, əgər varsa, nəzərə alınmayacaq.

Nümunə:
Əgər msg.payload JSON obyekti ehtiva edirsə, o, sorğuda daxil edilməyəcək.

Sorğu parametrlərinə əlavə et:
msg.payload-dan olan məlumatlar sorğu parametrlərinə (Query Parameters) çevriləcək və URL-ə əlavə olunacaq.

Nümunə:
Əgər msg.payload aşağıdakıları ehtiva edirsə:
```
{
  "key1": "value1",
  "key2": "value2"
}
```
Əgər Bağlantı http://example.com/api olaraq göstərilibsə, yekun sorğu belə olacaq:
GET http://example.com/api?key1=value1&key2=value2.

Sorğu bədənində göndər:
msg.payload-dan olan məlumatlar sorğu bədənində göndəriləcək. Bu variant POST, PUT və PATCH kimi metodlar üçün uyğundur, burada məlumatlar tez-tez bədəndə ötürülür.

Nümunə:
Əgər msg.payload aşağıdakıları ehtiva edirsə:
```
{
  "name": "John Doe",
  "email": "john.doe@example.com"
}
```
Əgər sorğu metodu POST-dursa, məlumatlar uyğun məzmunla sorğu bədənində göndəriləcək.

5. Cavab

Düyünün serverdən aldığı cavabı hansı formatda emal edəcəyini müəyyən edir.

Variantlar:

UTF-8 string: Cavab stringə çevrilir (standart olaraq).
Buffer: Cavab Buffer obyekti şəklində qaytarılır (şəkillər və ya fayllar kimi ikili məlumatlar üçün faydalıdır).
JSON: Əgər serverin cavabı JSON formatındadırsa, avtomatik olaraq JavaScript obyektinə çevrilir.

Nümunə:

Əgər JSON seçilibsə, cavab:

{"status": "ok", "value": 42}

Aşağıdakı kimi çevriləcək:

msg.payload = { status: "ok", value: 42 };

6. Autentifikasiya

Düyün daxili autentifikasiya mexanizmlərini dəstəkləyir.

Basic Auth

İstifadəçi adı: İstifadəçi adı.
Şifrə: Şifrə.

Bearer Token

Token: Giriş tokeni.

Digest

İstifadəçi adı: İstifadəçi adı.
Şifrə: Şifrə.

Giriş məlumatları

HTTP sorğusu düyünü msg mesaj obyektini aşağıdakı parametrlərlə qəbul edir:

msg.url: Sorğu üçün URL (əgər düyün parametrlərində göstərilməyibsə).
msg.method: HTTP metodu (əgər düyün parametrlərində göstərilməyibsə).
msg.payload: Sorğu bədəni ( POST, PUT, PATCH metodları üçün istifadə olunur).
msg.headers: HTTP sorğusunun başlıqları (obyekt).

Çıxış məlumatları

Düyün icra olunmuş sorğu haqqında məlumatla msg obyektini qaytarır:

msg.payload: Serverdən alınan cavab məlumatları.
msg.statusCode: Cavabın HTTP status kodu (məsələn, 200 və ya 404).
msg.headers: Cavab başlıqları.
msg.responseUrl: Sorğunun icra edildiyi URL.
msg.error: Xətanın təsviri (əgər sorğu uğursuz olarsa).

İstifadə nümunələri

Nümunə 1: GET sorğusunun icrası

Düyün parametrləri:

Metod: GET
URL: https://api.weatherapi.com/v1/current.json?key=API_KEY&q=London

Axın:

[inject] ---> [http request] ---> [debug]

Nəticə: Düyün cari hava ilə bağlı JSON qaytaracaq.

Nümunə 2: POST vasitəsilə məlumat göndərilməsi

Düyün parametrləri:

Metod: POST
URL: https://api.example.com/devices
Məlumat: JSON

Axın:

[function] ---> [http request] ---> [debug]

Düyün function-da kod:

msg.payload = {
    deviceId: "sensor123",
    status: "active"
};
msg.headers = { "Content-Type": "application/json" };
return msg;

Nəticə: Məlumatlar göndəriləcək və düyün serverin cavabını qaytaracaq.

Nümunə 3: Dinamik URL və autentifikasiya

Düyün parametrləri:

URL: (boş qoyun)

Axın:

[function] ---> [http request] ---> [debug]

Düyün function-da kod:

msg.url = "https://api.example.com/user/123";
msg.headers = { Authorization: "Bearer YOUR_TOKEN" };
return msg;

Nəticə: Düyün göstərilən URL-ə autentifikasiya tokeni ilə sorğu icra edəcək.

HTTP sorğusu düyünü