Ana içeriğe geç

HTTP Node'u

HTTP node'u, akışınızdan doğrudan herhangi bir harici web API'sini çağırır. Hazır bir aracın olmadığı durumlarda veri getirmek, güncellemeler göndermek veya başka bir sistemi tetiklemek için kullanın — özel bir arka uç, bir iş ortağı API'si, bir webhook alıcısı vb. Yöntemi, URL'yi, başlıkları, sorgu parametrelerini ve gövdeyi siz kontrol edersiniz.

Bir akışa ekleme​

Canvas üzerine bir HTTP node'u sürükleyin ve önceki node'u ona bağlayın. Yöntemi ve URL'yi ayarlayın, ardından API'nin ihtiyaç duyduğu başlıkları, sorgu parametrelerini veya gövdeyi ekleyin.

GET metodu ve bir URL ile HTTP node'u

Girdiler​

ParametreAçıklamaZorunlu
MethodHTTP yöntemi: GET, POST, PUT, DELETE veya PATCH. Varsayılan: GET.Evet
URLÇağrılacak uç nokta. Bu alan düz bir metin alır — URL'deki {{ }} değişkenleri çözümlenmez ve olduğu gibi gönderilir. Bir isteğe dinamik veri koymak için Query Params veya Body kullanın (ikisi de değişkenleri çözümler).Evet
HeadersAnahtar/değer başlık çiftleri (örneğin bir Authorization veya Content-Type başlığı). Değerler değişken kullanabilir.Hayır
Query ParamsURL'ye sorgu dizesi parametreleri olarak eklenen anahtar/değer çiftleri. Değerler değişken kullanabilir.Hayır
Body Typeİstek gövdesinin biçimi: JSON, Raw, Form Data veya x-www-form-urlencoded.Hayır
Bodyİstek gövdesi. JSON/Raw için bir metin alanı veya form türleri için anahtar/değer satırları. Body Type'a göre gösterilir.Hayır
Response TypeYanıtın nasıl okunacağı: JSON, Text, Array Buffer veya Raw (Base64).Hayır
Çıktıyı Sohbette GösterBu node'un çıktısının sohbet geçmişinde görünüp görünmeyeceği. Varsayılan olarak kapalı.Hayır
Max RetriesBir istek geçici bir sorundan dolayı başarısız olursa, otomatik olarak kaç kez yeniden deneneceği (0 yeniden denemeyi devre dışı bırakır). Varsayılan 3.Hayır
Retry Delay (ms)İlk yeniden denemeden önce ne kadar bekleneceği; bekleme süresi her başarısız denemeden sonra iki katına çıkar. Varsayılan 1000.Hayır

Başlığı elle oluşturmak yerine kimlik doğrulamayı otomatik olarak yönetmek için node'a bir HTTP Credential (Basic Auth, Bearer Token veya API Anahtarı) eklenebilir.

Çıktılar​

HTTP node'unun tek bir çıktısı vardır: API'nin yanıtı. Bunu sonraki node'larda okuyun veya parçalarını Akış Değişkenleri'ne yakalayın. Response Type'ı JSON olarak ayarlarsanız, yanıt alanlarına referans verebilmeniz için ayrıştırılır.

Yöntem, başlıklar ve gövde​

  • Method + URL isteği tanımlar. Okumak için GET, veri göndermek için POST/PUT/PATCH, kaldırmak için DELETE kullanın.
  • Headers, kimlik doğrulama token'ları ve içerik türü gibi şeyleri taşır. Örneğin, Content-Type: application/json.
  • Query Params, URL'ye ?status=open gibi filtreler ekler.
  • Body, gönderdiğiniz veriyi tutar. Çoğu API için JSON seçin ve yükü gövde alanına yazın. Dosya yüklemeleri veya klasik web formları için, Form Data veya x-www-form-urlencoded kullanın ve anahtar/değer satırlarını doldurun.

Şablon değişkenleri​

Headers, Query Params ve Body alanları {{ }} değişkenlerini destekler, böylece istekleri canlı konuşma verilerinden oluşturabilirsiniz:

  • Başlık değeri: Bearer {{$vars.apiToken}}
  • Query param değeri: {{$flow.state.customerId}}
  • JSON gövdesi: { "message": "{{$question}}", "session": "{{$flow.sessionId}}" }

URL alanı istisnadır — düz gönderilir, bu yüzden bir değişken yolun (path) içine değil bir query param'a aittir. Belirli bir kaydı aramak için, id'sini URL yoluna gömmek yerine bir query param olarak geçirin (?id={{$flow.state.customerId}}).

Ekleyebileceğiniz tam liste için bkz. Değişkenler.

JSON gövdeli bir POST olarak yapılandırılmış HTTP node'u

Örnek​

Yakalanan bir lead'i harici bir CRM'e gönderin:

  • Method: POST
  • URL: https://api.mycrm.com/v1/leads
  • Headers: Authorization → Bearer {{$vars.crmToken}}, Content-Type → application/json
  • Body Type: JSON
  • Body: { "name": "{{$flow.state.name}}", "email": "{{$flow.state.email}}" }
  • Response Type: JSON

İpuçları​

  • Sırları düz metinde tutmayın — API token'larını Custom Değişkenler olarak ({{$vars.myToken}}) saklayın veya bir HTTP Credential kullanın.
  • API JSON döndürdüğünde, sonraki node'ların tekil alanları okuyabilmesi için Response Type'ı JSON olarak ayarlayın.
  • Kararsız uç noktalar için Max Retries'ı açık bırakın, ancak iki kez çalışmaması gereken eylemler için (bir ödeme gibi) 0'a ayarlayın.
  • Bir istek başarısız olursa, tam URL'yi, durum kodunu ve yanıtı görmek için yürütme izini açın.

İlgili​