Sparround

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ərbody.

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çimNə edirNə vaxt lazım olur
Predefined Credential Typen8n-in tanıdığı servisin hazır credential tipini işlədirServisin node-u var, amma lazım olan əməliyyat yoxdur — n8n bunu tövsiyə edir
Generic Credential TypeHeader, 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əkAPI 100-dən çox qeyd qaytaranda
BatchingSorğuları partiyalara bölür və aralarına fasilə qoyurAPI rate limit-i olanda
TimeoutCavabın başlanmasını nə qədər gözləyəcəyi (millisaniyə)Yavaş və ya etibarsız servis
Never ErrorStatus kodu nə olursa olsun uğurlu sayırXəta kodlarını özün emal etmək istəyəndə
Include Response Headers and StatusYalnız body deyil, header və status kodu da qaytarırStatus 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