Dış istek adımı çalışmıyor

Akışınıza bir dış istek adımı koydunuz — stok sorgusu, sipariş durumu ya da kendi sisteminize kayıt — ama adım hata veriyor ve akış "Sonra" kolundan devam etmiyor. Bu adım panelin dışına çıkan tek işlemdir, bu yüzden kendine özgü güvenlik kuralları ve hız sınırları vardır. Bu rehber oturum kaydındaki nedene göre doğru düzeltmeyi bulmanızı sağlar.

⚠️ Not: Güvenlik gereği yalnız genel internete istek atılır. İç ağ ve yerel adresler, panelin kendi adresi ve 80 ile 443 dışındaki portlar reddedilir. Bu kısıtlar kapatılamaz.

Şu durumlardan biriyle karşılaşmış olabilirsiniz:

• Kayıtta "Dış istek başarısız" yazıyor.
• Kayıtta "Dış istek ertelendi" yazıyor.
• İstek gidiyor ama yanıttaki değerler kişi kartına yazılmıyor.
• Denemede çalışıyor, canlıda çalışmıyor.

Somut bir örnek: bir e-ticaret işletmesi, kargo takip numarasını kendi sisteminden çeken bir adım kuruyor. Deneme başarılı, canlıda ise adım hiç sonuç döndürmüyor. Sebep, adımın kendi sunucularının yerel ağ adresine kurulmuş olmasıdır; bu adres güvenlik gereği reddedilir. Sistem genel internete açık bir alan adı üzerinden çağrıldığında adım ilk denemede çalışıyor.

Oturum kaydındaki nedeni okuyun

1. Otomasyonlar › ilgili otomasyon › Kayıtlar bölümünden oturumu açın.
2. Dış istek ya da Dış istek başarısız olayını bulun.
3. Neden satırındaki metni okuyun ve aşağıdaki karşılığına bakın.

Adres ve biçim hataları:

• "İstek adresi geçersiz." Adres okunamadı. https:// ile başladığından ve yer tutucuların doğru doldurulduğundan emin olun.
• "Yalnız http/https adresleri çağrılabilir." Başka bir şema (ör. ftp://) yazılmış.
• "Yalnız 80 ve 443 portlarına istek atılabilir." Adreste başka bir port var.
• "Adres çözülemedi." Alan adı yanlış ya da DNS kaydı yok.
• "Başlık değeri geçersiz." Bir başlıkta kabul edilmeyen karakter var.

Güvenlik reddi:

• "İç ağ adresine istek reddedildi." Adres özel bir ağa çıkıyor. Genel bir adres kullanın.
• "Panelin kendi adresine istek atılamaz." Akış kendi kendini çağıramaz.
• "Yönlendirme başka bir adrese gittiği için durduruldu." Hedef sizi başka bir alan adına yönlendirdi; son adresi doğrudan yazın.
• "Yönlendirme izlenemedi." Yönlendirme zinciri izlenemedi.

Karşı taraf kaynaklı:

• "Dış istek zaman aşımına uğradı." Adımdaki süre doldu. Süreyi artırın (1–30 saniye) ve "Süre doldu" çıkışına bir kol bağlayın.
• "Sunucu hata döndü." Karşı sistem hata kodu verdi; o sistemin günlüklerine bakın.
• "Dış isteğe ulaşılamadı." Ağ sorunu. Yeniden deneme ayarını artırabilirsiniz; yeniden deneme yalnız GET isteklerinde uygulanır.

Bağlantı ayarlarını denetleyin

Adımda hazır bir bağlantı kullanıyorsanız adres, kimlik ve varsayılan başlıklar portföy ayarlarından gelir.

1. Portföy ayarları › Bağlantılar ekranını açın.
2. İlgili bağlantıyı bulun ve Temel adres alanının https:// ile başladığını doğrulayın.
3. Kimlik doğrulama yöntemini hizmetin belgeleriyle karşılaştırın: Yok, Kullanıcı adı ve parola, Bearer anahtarı, Başlıkta API anahtarı ya da Token adresinden alınan anahtar.
4. Dene düğmesiyle bağlantıyı sınayın.
5. Kayıtta şu nedenleri görürseniz sorun bağlantıdadır:
   • "Bağlantı bulunamadı." Bağlantı silinmiş ya da bu hesapta kullanıma açık değil.
   • "Bağlantının gizli değeri okunamadı." Anahtarı yeniden girin.
   • "Bağlantının anahtarı alınamadı." Token adresinden anahtar alınamadı; Token adresi ve Anahtarın yolu alanlarını denetleyin.
   • "Bağlantının adresi geçersiz." Temel adresi düzeltin.
6. Bağlantının kapsamını denetleyin: Tüm hesaplar mı, Seçilen hesaplar mı? Hesap seçilmemişse adımda görünmez.

Hız sınırına takıldıysanız

Dış istekler hesap başına dakikalık bir pencereyle sınırlıdır; bu, karşı sistemin kotasını ve sizin hesabınızı korur.

• Akışın kendi istekleri dakikada 30 ile sınırlıdır.
• Düzenleyicideki Dene düğmesi dakikada 10 ile sınırlıdır.
• Bağlantılar ekranındaki Dene düğmesi portföy başına dakikada 10 ile sınırlıdır.
• Pay verilmediğinde oturum bekletilir ve kayıtta Dış istek ertelendi görünür. Belirli sayıda ertelemeden sonra oturum "Dış istek sınırı doldu" nedeniyle biter.

Çözüm: isteği her mesajda değil yalnız gerektiğinde atın; adımın önüne bir koşul koyarak gereksiz çağrıları eleyin.

Yanıt işlenmiyorsa

İstek başarılı ama sonuç akışa geçmiyorsa eşleme ve kollara bakın.

1. Adımı açın ve Yanıt eşlemeleri bölümünü denetleyin. Yanıttaki alan adını birebir yazın; en çok 10 eşleme kurabilirsiniz.
2. Yanıta göre kollar bölümünde Yanıttaki yol ve Beklenen değer alanlarını karşılaştırın. İlk eşleşen kol izlenir; hiçbiri tutmazsa Sonra çıkışı kullanılır.
3. Yanıtın yalnız ilk 256 KB'ı okunur. Çok büyük yanıtlarda aradığınız alan kesilmiş olabilir; karşı sistemden daha dar bir yanıt isteyin.
4. Kayıttaki "Yazılan alanlar" satırı, kişi kartına gerçekten hangi alanların yazıldığını gösterir.

Diğer bilinen sorunlar ve kısıtlar

• Denemede yalnız okuyan istek atılır. Simülatörde POST, PUT ve DELETE çalıştırılmaz; kayıtta "Denemede yalnız okuyan (GET) istek atılır" yazar.
• Adım plana bağlıdır. "Planınız bu adımı kapsamıyor." iletisi alıyorsanız portföy sahibi planı yükseltmelidir.
• Anahtarlar akışa yazılmaz. Gizli değerler şifreli saklanır ve yalnız bağlantının kendi adresine gönderilir; akışı paylaşmak anahtarı paylaşmaz.
• Gövde JSON ise yer tutucular kaçışla doldurulur. Kişinin yazdığı tırnak işareti gövdeyi bozmaz.
• Süre sınırı 30 saniyedir. Daha uzun süren işlemler için karşı sistemden hemen yanıt alıp sonucu ayrı bir çağrıyla sorgulayın.

Tüm adımları uyguladığınız hâlde sorun sürüyorsa Destek ekibimizle iletişime geçin.