İçeriğe atla

Dış istek adımı

Başka bir sisteme HTTP çağrısı atan adım; bağlantı ve tam adres kurulumu, başlıklar, gövde, yanıt eşlemeleri, yanıta göre kollar, süre ve yeniden deneme ayarları, Dene paneli ve güvenlik sınırları.

Son güncelleme: 30 Eylül 2026

Bu sayfada

"Sipariş numaram 4821, nerede?" sorusunun cevabı panelde değil, sizin kargo ya da sipariş sisteminizdedir. Dış istek adımı akışın içinden o sisteme bir çağrı atar, gelen yanıttan bilgi alır ve isterse yanıta göre akışı dallandırır. Bu rehber adımın bütün alanlarını, iki kurulum yolunu, güvenlik sınırlarını ve "Dene" panelini anlatır.

Bu makalede şunları bulacaksınız:

  • Ne işe yarar
  • İki kurulum: bağlantı mı, tam adres mi
  • Ayarlar
  • Yanıt eşlemeleri
  • Yanıta göre kollar
  • Dene paneli
  • Çıkışları
  • Güvenlik ve hız sınırları
  • Örnek kullanım
  • Sık yapılan hatalar
  • Kısıtlar ve sınırlar

⚠️ Not: Bu adım, karşı sistemin bir API'si (dışarıdan çağrılabilen bir adresi) olmasını gerektirir. Sisteminizde böyle bir şey var mı bilmiyorsanız yazılımcınıza ya da sağlayıcınıza sorun; panelden bu adresi kendiniz üretemezsiniz.

Ne işe yarar

Adım, verdiğiniz adrese bir HTTP isteği gönderir ve yanıtı bekler. Gelen yanıttan seçtiğiniz değerleri kişi kartına yazar; isterseniz yanıtın içeriğine göre akışı farklı kollara ayırır.

Tipik kullanımlar: sipariş durumu sorgulama, stok kontrolü, randevu takvimine kayıt, kendi CRM'inize kişi yazma, bir kupon kodu üretme.

Adım kişiye hiçbir şey göndermez ve iki kanalda da çalışır.

İki kurulum: bağlantı mı, tam adres mi

Hedef ayarında iki yol vardır ve hangisini seçtiğiniz geri kalan alanları değiştirir.

Bağlantı (önerilen)

Portföy ayarları › Bağlantılar bölümünde bir kez tanımlanan hazır bağlantıyı seçersiniz. Adres, kimlik (anahtar, jeton) ve varsayılan başlıklar oradan gelir; adımda yalnız Yol yazarsınız.

Bu yolun iki büyük faydası vardır: gizli değer akışın içine hiç girmez (akışı kopyalasanız da anahtar kopyalanmaz) ve anahtar değiştiğinde tek yerden güncellenir.

Hesapta tanımlı bağlantı yoksa panel "Bu hesapta tanımlı bağlantı yok" der ve sizi Portföy ayarlarına yönlendirir.

Tam adres yaz

Eski usul: Adres alanına bütün adresi yazarsınız. Bağlantı gerektirmeyen, kimlik istemeyen genel uçlar için yeterlidir.

Ayarlar

Yöntem

GET ya da POST.

  • GET bilgi okur. Yeniden denenebilir.
  • POST bilgi yazar (kayıt oluşturur). Tekrarı sipariş kopyalayabileceği için yeniden deneme yalnız GET'te uygulanır.

Adres

Yalnız "tam adres yaz" seçiliyken görünür. https:// ile başlamalı. Yer tutucu kullanabilirsiniz.

Boşsa ya da http(s) ile başlamıyorsa yayın öncesi kontrol hata verir.

Yol

Yalnız bağlantı seçiliyken görünür, en çok 400 karakter. Bağlantının temel adresinin ardına eklenir: /siparis/{{field.siparis_no}} gibi. Yer tutucu kullanabilirsiniz.

Baştaki eğik çizgi fark etmez; siparis/5 ile /siparis/5 aynı adresi üretir. İki yazım uyarı alır: tam adres yapıştırmak (bağlantının adresinin ardına eklenir, beklediğiniz yere gitmez) ve yolda .. kullanmak (bağlantının adresinin dışına çıkar).

Başlıklar

İsteğe eklenecek HTTP başlıkları, en çok 5 tane. Başlık ekle ile eklersiniz; her satırda Ad ve Değer vardır.

Bazı başlık adları gönderilmez: host, content-length, connection, transfer-encoding, cookie, authorization ve authorization-proxy. Bunlar isteğin kendi kimliğini ya da gövde sınırını değiştirir.

⚠️ Not: Kimlik için Authorization başlığı elle yazılamaz; yazarsanız gönderilmez ve kontrol sizi uyarır. Kimlik artık Portföy ayarları › Bağlantılar üzerinden gelir. Bunun sebebi güvenliktir: anahtarınız akış JSON'una yazılmaz.

Gövde

Yalnız POST'ta gönderilir, en çok 4.000 karakter. JSON ya da düz metin yazabilirsiniz. Yer tutucu kullanabilirsiniz.

Gövde JSON ise ({ ya da [ ile başlıyorsa) yer tutucular JSON kaçışıyla doldurulur: kişinin yazdığı bir tırnak işareti gövdeyi bozmaz.

Süre (saniye)

Yanıt kaç saniye beklenecek: 1 ile 30 arası, varsayılan 10. Bütün istek (yönlendirmeler dahil) bu bütçeye sığar. Süre dolarsa akış Süre doldu çıkışından devam eder.

Yeniden deneme

Ağ hatası ve sunucu hatasında (5xx) kaç kez yeniden denensin: 0 ile 3 arası, varsayılan 0. Yalnız GET'te uygulanır.

Yanıt eşlemeleri

Yanıt JSON ise içinden değer alıp kişi kartına yazabilirsiniz. Eşleme ekle ile satır eklersiniz; her satırda iki alan vardır:

  • Yanıttaki yol — nokta yazımıyla: data.id, items.0.name. Boş bırakılırsa yanıtın tamamı (kırpılmış) yazılır.
  • Kaydedilecek alan — kişi kartındaki alan.

En çok 10 eşleme olabilir. Yolu yazılmış ama alanı seçilmemiş satır yok sayılır; kontrol bunu uyarı olarak gösterir. Aynı alana iki eşleme yazarsanız da uyarı alırsınız.

Yol biçimi geçersizse (yazım hatası) kontrol hata verir ve yayını engeller.

Yanıta göre kollar

Adım, gelen yanıta göre akışı dallandırabilir. Kol ekle ile en çok 5 kol eklersiniz; her kolda dört alan vardır:

  • Kol adı — çıkışın adı, en çok 40 karakter.
  • Yanıttaki yol — karşılaştırılacak değerin yolu; boşsa yanıtın tamamı okunur.
  • İşleç — eşittir, eşit değil, içerir, içermez, ile başlar, büyüktür, küçüktür, boş, dolu.
  • Beklenen değer — karşılaştırılacak değer; yer tutucu kullanabilirsiniz.

İlk eşleşen kol kazanır. Hiçbiri tutmazsa akış Sonra çıkışından devam eder.

Değer isteyen bir işleçte (boş/dolu dışında hepsi) beklenen değeri boş bırakırsanız kontrol hata verir: o kol hiçbir zaman eşleşmez.

Dene paneli

Adımın ayar panelinde bir Dene bölümü vardır. Burada isteği canlıya çıkmadan çalıştırırsınız.

  • Yer tutucular için örnek değer yazarsınız; gerçek kişi bilgisi kullanılmaz.
  • Dene'ye bastığınızda sonuç görünür: Yanıt alındı, Alınamadı ya da Süre doldu.
  • Yanıt JSON ise panelin altında yanıttaki yollar listelenir; bir yola tıkladığınızda o yol eşlemeye (ya da kola) eklenir. Yolu elle yazmanız gerekmez.
  • Hangi kolun izleneceği de gösterilir.

⚠️ Not: POST denemesi karşı sistemde gerçek bir kayıt oluşturabilir. Panel bunu size sorar ve onayınızı ister. Sipariş, ödeme ya da kayıt oluşturan bir uçta test ortamı adresi kullanın.

Çıkışları

Adımın çıkışları şunlardır:

  • Kollar — tanımladığınız her yanıt kolu, kendi adıyla.
  • Sonra — yanıt alındı ama hiçbir kol eşleşmedi.
  • Alınamadı — ağ hatası, sunucu hatası, geçersiz adres, engellenen adres.
  • Süre doldu — süre içinde yanıt gelmedi. Bu çıkış bağlanmamışsa çalışma anı Alınamadı koluna düşer.

Kolları ve hata çıkışlarını bağlamayın derseniz oturum sebep yazmadan biter; kontrol bağlanmamış kolları uyarı olarak listeler.

Güvenlik ve hız sınırları

Bu adım sunucunuzdan dışarıya istek attığı için ayrıca korunur:

  • Yalnız genel internete çıkılır. İç ağ, yerel ve özel adresler (localhost, .local, .internal, özel IP blokları) reddedilir. Bu, sunucunun kendi iç servislerine çağrı yapmaya zorlanmasını engeller.
  • Yönlendirmeler elle izlenir ve en çok 3 yönlendirme kabul edilir; her adımda aynı denetim yeniden yapılır.
  • Yanıtın ilk 256 KB'ı okunur.
  • Hesap başına dakikada 30 akış isteği ve 10 deneme hakkı vardır. Pay verilmezse oturum ertelenir (hata değildir). Aynı adımda en çok 5 erteleme kabul edilir; sonrasında oturum hatayla biter.

Örnek kullanım

Bir e-ticaret işletmesi, "siparişim nerede" sorusunu otomatikleştirmek istiyor.

  1. Yazılımcısı, sipariş numarasına göre durum döndüren bir uç hazırlıyor. Portföy sahibi Portföy ayarları › Bağlantılar'dan bağlantıyı tanımlıyor (adres + anahtar).
  2. Başlangıç adımına kargo anahtar kelimesini ekliyor.
  3. Bilgi topla adımıyla siparis_no alıyor.
  4. Dış istek adımı ekliyor: Hedef bağlantı, Yöntem GET, Yol /siparis/{{field.siparis_no}}, Süre 10, Yeniden deneme 1.
  5. Dene panelinden örnek bir sipariş numarası yazıp deniyor; dönen yollara tıklayarak iki eşleme ekliyor: data.durum → kargo_durumu, data.takip_no → takip_no.
  6. İki kol tanımlıyor: Teslim edildi (data.durum eşittir teslim) ve Yolda (data.durum eşittir yolda).
  7. Kolların altına ayrı mesajlar, Sonra koluna "Siparişinizi bulamadım" mesajı, Alınamadı ve Süre doldu kollarına ortak bir "Sistemimizde geçici bir sorun var, ekibimiz bakacak" mesajı + insana devret eylemi bağlıyor.

Sık yapılan hatalar

Anahtarı Authorization başlığına elle yazmak. Gönderilmez. Kimliği Portföy ayarları › Bağlantılar'a taşıyın.

Hata kollarını bağlamamak. Karşı sistem her zaman ayakta değildir; kişi yanıtsız kalır.

Yanıt yolunu tahmin etmek. data.durum mu sonuc.durum mu bilmiyorsanız Dene panelinden yanıtı görün ve yola tıklayın.

POST'u gerçek sistemde denemek. Deneme gerçek kayıt oluşturabilir. Test ortamı adresi kullanın.

Süreyi 30 saniyeye çekmek. Uzun süre kişiyi bekletir ve kuyruğu yavaşlatır. Çoğu uç 10 saniyenin altında yanıt verir.

POST'a yeniden deneme yazmak. Yalnız GET'te uygulanır; POST'a yazdığınız değer çalışmaz.

Kendi yerel sunucunuzun adresini yazmak. İç ağ adresleri reddedilir.

Yanıtın tamamını tek alana yazmak. Yolu boş bırakırsanız gövdenin kırpılmış hâli alana yazılır; okunmaz bir metin olur. İhtiyacınız olan değeri yolla seçin.

Kısıtlar ve sınırlar

  • Yöntem GET ya da POST; yeniden deneme yalnız GET'te.
  • Adres https ile başlamalı; iç ağ ve yerel adresler reddedilir.
  • Yol en çok 400, gövde en çok 4.000, başlık değeri en çok 300 karakter; en çok 5 başlık.
  • Yasak başlık adları gönderilmez (authorization dahil).
  • En çok 10 yanıt eşlemesi, en çok 5 kol.
  • Süre 1-30 saniye (varsayılan 10), yeniden deneme 0-3 (varsayılan 0).
  • En çok 3 yönlendirme; yanıtın ilk 256 KB'ı okunur.
  • Dakikada 30 akış isteği, 10 deneme; aynı adımda en çok 5 erteleme.
  • Adım planınıza bağlıdır; kapsam dışındaysa oturum burada durur.

İlgili kavramlar

Yanıta göre yol ayırmanın basit hâli için Koşul adımı'na, aldığınız bilgiyi mesajda kullanmak için Değişken ve yer tutucu yazısına bakın. Adım çalışmıyorsa Dış istek adımı çalışmıyor rehberi kayıtlardan başlayarak nedenleri sıralar.

Dış istek adımı, otomasyonunuzu "hazır cevap veren" bir araçtan "sizin verinizi bilen" bir araca dönüştürür.

Bu makale yardımcı oldu mu?