HTTP Request: istənilən API-yə qoşulmaq
HTTP Request n8n-in ən vacib node-udur. Hazır node-lar minlərlə servisi əhatə edir, amma sənin lazım olan servisin node-u olmayanda — və ya olan node lazım olan əməliyyatı dəstəkləməyəndə — bu node ilə istənilən REST API-yə çıxırsan.
Əsas parametrlər tanışdır: metod (GET, POST, PUT, PATCH, DELETE), URL, query parametrləri, header-lər və body.
Body üçün bir neçə format var: JSON, Form-Data, Form URLencoded, Raw və n8n Binary File — sonuncu fayl yükləmək üçündür.
Ən sürətli başlanğıc: cURL import. API sənədləşməsindən və ya Postman-dan curl əmrini kopyalayıb node-a import edirsən — n8n bütün parametrləri özü doldurur.
| Seçim | Nə edir | Nə vaxt lazım olur |
|---|---|---|
| Predefined Credential Type | n8n-in tanıdığı servisin hazır credential tipini işlədir | Servisin node-u var, amma lazım olan əməliyyat yoxdur — n8n bunu tövsiyə edir |
| Generic Credential Type | Header, Basic, Bearer, Query, OAuth2 kimi ümumi tiplər | Öz və ya naməlum API |
| Pagination | Çoxsəhifəli cavabı avtomatik gəzir: parametri artıraraq və ya cavabdakı növbəti URL-i izləyərək | API 100-dən çox qeyd qaytaranda |
| Batching | Sorğuları partiyalara bölür və aralarına fasilə qoyur | API rate limit-i olanda |
| Timeout | Cavabın başlanmasını nə qədər gözləyəcəyi (millisaniyə) | Yavaş və ya etibarsız servis |
| Never Error | Status kodu nə olursa olsun uğurlu sayır | Xəta kodlarını özün emal etmək istəyəndə |
| Include Response Headers and Status | Yalnız body deyil, header və status kodu da qaytarır | Status koduna görə qərar verəndə; rate limit header-lərini oxuyanda |
Səhifələmə (pagination) n8n-də node-un öz seçimi ilə həll olunur və iki rejimi var:
- Update a Parameter in Each Request — hər sorğuda parametri (səhifə nömrəsi, offset) dəyişirsən
- Response Contains Next URL — API cavabında növbəti səhifənin URL-ini verir, sən onu expression ilə göstərirsən
Səhifələmə qurarkən n8n üç hazır dəyişən verir: $pageCount (neçə səhifə çəkilib), $request (göndərilən sorğu) və $response (gələn cavab — $response.body, $response.headers, $response.statusCode daxil).
API-lərin səhifələmə üsulları fərqlidir, ona görə qurmazdan əvvəl ya sənədləşməyə baxmaq, ya da bir sorğu göndərib cavabın strukturunu görmək lazımdır. Standart olmayan sxem varsa, Loop Over Items ilə dövrü əl ilə qurmaq alternativdir.
HTTP Request node-una 10 item gəlirsə 10 sorğu göndərilir. Bu, rate limit-i yandırmağın ən sürətli yoludur. Node-un öz Batching seçimi (partiyadakı item sayı + partiyalar arası fasilə) məhz bunun üçündür — Loop Over Items qurmadan əvvəl ona bax.
📚 Mənbələr və sənədlər
- HTTP Request noderəsmidocs.n8n.io
Bütün parametrlər, səhifələmə rejimləri və cURL importunun rəsmi mənbəyi.
- Səhifələmə nümunələrirəsmidocs.n8n.io
- HTTP Request — tipik problemlərrəsmidocs.n8n.io