Bağlantılar
Akışlardaki dış istek adımlarının kullandığı hizmet bağlantıları. Temel adres, beş kimlik doğrulama yöntemi, varsayılan başlıklar, kapsam ve deneme.
Son güncelleme: 30 Eylül 2026
Bu sayfada
Bir akışta müşterinin sipariş durumunu kendi sisteminizden sormak isterseniz, panelin o sisteme nasıl bağlanacağını bilmesi gerekir. Portföy ayarları › Bağlantılar, bu bilgiyi bir kez kaydettiğiniz yerdir: adres, kimlik bilgisi ve varsayılan başlıklar. Akış adımında sonra yalnız bağlantıyı ve yolu seçersiniz; anahtar akışın içine yazılmaz. Bu rehber ekrandaki her alanı anlatır.
⚠️ Bu ekranı Sahip ve Yönetici açar ve yalnız planınızda entegrasyonlar açıksa menüde görünür. Ekran gizli değerler taşır; kapalı planda adres bilinse de açılmaz.
Ne işe yarar
Ekranın üstündeki bilgi kutusu işi tanımlar: "Bağlantı, dış istek adımının kullanacağı bir adres ve kimlik bilgisidir. Adımda yalnız bağlantıyı ve yolu seçersiniz; anahtar akışın içine yazılmaz."
Bu ayrımın iki faydası var:
- Gizlilik. API anahtarınız akışın içinde durmaz. Akışı gören biri (editör rolündeki bir ekip üyesi) anahtarı görmez.
- Tek yerden değiştirme. Anahtarınız değişirse yirmi akışı tek tek düzeltmeniz gerekmez; bağlantıyı bir kez güncellersiniz.
İkinci bilgi satırı güvenlik önlemlerini sayar: "Adresler iç ağ koruması ve zaman aşımıyla çağrılır; gizli değerler şifreli saklanır, yalnız bağlantının kendi adresine gönderilir." Yani panel, yazdığınız adresin iç ağa yönelmediğini denetler, sonsuza kadar beklemez ve gizli değerinizi başka bir adrese asla göndermez.
Ekrana nasıl girilir
- Sol üstteki hesap seçiciyi açın.
- Portföyün adının yanındaki dişli simgesine tıklayın.
- Menüden Bağlantılar'ı seçin.
Bağlantılar listesi
Kayıtlı bağlantıları listeler. Her satırda adı, temel adresi, kapsamı ve durum rozeti (Etkin / Kapalı) durur; yanında Düzenle, Dene ve Bağlantıyı sil düğmeleri vardır.
Liste boşsa "Henüz bağlantı yok." yazar.
Dene
Dene düğmesi bağlantıyı gerçekten sınar. Basıldığında kısa bir süre "Deneniyor…" yazar ve sonucu üç durumdan biriyle bildirir:
- Bağlandı — adres yanıt verdi.
- Bağlanamadı — adres yanıt vermedi ya da hata döndü.
- Süre doldu — adres zaman aşımına uğradı.
Sonucun altında kimliğin gönderilip gönderilmediği de yazar: "Kimlik bilgisi gönderildi." ya da "Kimlik doğrulama yok: istek kimliksiz gitti." Bu ikinci satır, kimlik doğrulamayı yanlışlıkla Yok bıraktığınızı yakalamanızı sağlar.
Bağlantıyı silme
Onay kutusu sonucu da söyler: "… silinsin mi? Bu bağlantıyı kullanan adımlar çalışmaz."
Bu, yapay zekâ anahtarlarından farklıdır: anahtarda yedek vardır, bağlantıda yoktur. Sildiğiniz bağlantıyı kullanan dış istek adımları çalışmaz. Silmeden önce hangi akışların o bağlantıyı kullandığını bilin.
Bağlantı ekleme formu
Listenin altındaki bölümdür; Bağlantı ekle ya da düzenlerken Bağlantıyı düzenle adını taşır.
Ad
Adımda bu adla seçilir. Anlaşılır tutun: "Sipariş sistemi", "Stok API", "CRM" gibi. Adım kutusunda yalnız bu ad görünür, adres görünmez.
Temel adres
Hizmetin kök adresidir ve https:// ile başlar. Adımda yazdığınız yol bunun sonuna eklenir.
Somut örnek: temel adres https://api.magazam.com/v1 ise adımda yol olarak /siparis/12345 yazarsınız ve çağrı https://api.magazam.com/v1/siparis/12345 adresine gider. Temel adresi doğru bölmek, aynı bağlantıyı farklı yollarla tekrar tekrar kullanmanızı sağlar.
Kimlik doğrulama
Hizmetin sizden nasıl bir kimlik beklediğini seçtiğiniz listedir. Hangisini seçeceğiniz hizmetin kendi belgelerinde yazar. Beş seçenek vardır ve her biri farklı alanlar açar.
Yok. Kimlik gönderilmez. Herkese açık bir uç için yeterlidir.
Kullanıcı adı ve parola. İki alan açar: Kullanıcı adı ve Parola. Panel bunları standart temel kimlik doğrulama başlığında gönderir.
Bearer anahtarı. Tek bir Anahtar alanı açar. En yaygın yöntemdir; panel anahtarı Authorization: Bearer … başlığında gönderir.
Başlıkta API anahtarı. Üç alan açar:
- Anahtar — gizli değer.
- Başlık adı — anahtarın hangi başlıkta gideceği. Boş bırakırsanız
Authorizationkullanılır. - Değerin öneki — anahtarın önüne yazılacak metin, varsa. Bazı hizmetler
Tokenya daApiKeygibi bir önek ister.
Token adresinden alınan anahtar. En karmaşık yöntemdir: panel önce bir adrese giderek geçici bir anahtar alır, sonra onunla istek yapar. Alanları:
- Token adresi — anahtarın alınacağı https adresi.
- İstemci kimliği ve İstemci gizli anahtarı — hizmetin verdiği kimlik çifti.
- Kimlik nasıl gönderilsin — iki seçenek: İstek gövdesinde ya da Kullanıcı adı ve parola başlığında. Hizmetin belgelerinde hangisi yazıyorsa onu seçin.
- Ek alanlar — token adresine gönderilecek ek alanlar (en çok 10). Bazı hizmetler
scopeya dagrant_typegibi alanlar ister. - Anahtarın yolu — yanıttaki hangi alanın anahtar olduğu. Boş bırakırsanız
access_tokenkullanılır. - Sürenin yolu — anahtarın kaç saniye geçerli olduğunu yazan alan. Boş bırakırsanız
expires_inkullanılır.
Gizli alanların hepsi aynı kuralla çalışır: şifreli saklanır, bir daha gösterilmez. Düzenlerken boş bırakırsanız kayıtlı değer korunur.
Varsayılan başlıklar
Her istekte gönderilecek başlıkların listesidir; en çok 10 satır ekleyebilirsiniz. Her satır bir ad ve bir değer alır; satırı kaldırmak için yanındaki Satırı sil düğmesine dokunun.
Buraya genelde Accept: application/json ya da hizmetin istediği bir sürüm başlığı yazılır. Notun söylediği bir kural var: kimlik başlığı buraya yazılmaz. Kimlik için yukarıdaki kimlik doğrulama bölümünü kullanın; ikisi karışırsa başlık iki kez gönderilir ve hizmet reddeder.
Kullanılacağı hesaplar
Yapay zekâ anahtarlarındaki mantığın aynısı:
- Tüm hesaplar — portföyün bütün hesapları bu bağlantıyı kullanır.
- Seçilen hesaplar — yalnız dokunarak seçtiğiniz hesaplar. Hiç seçmezseniz listede "Hesap seçilmedi" yazar ve bağlantı hiçbir yerde kullanılmaz.
Bu bağlantıyı kullan
Bir işaret kutusudur; bağlantının Etkin mi Kapalı mı olacağını belirler. Kapatmak silmekten daha güvenlidir: bağlantı kayıtlı kalır, adımlar onu bulamaz ama silinmiş de olmaz.
Kaydetme
Yeni bağlantı için Bağlantıyı ekle, düzenlerken Kaydet düğmesine basın.
Kurulum sırası önerisi
- Hizmetin belgelerini açın ve iki şeyi bulun: kök adres ve kimlik doğrulama yöntemi.
- Bağlantıyı bu iki bilgiyle ekleyin, kapsamı önce Seçilen hesaplar yapıp tek bir hesap işaretleyin.
- Dene ile sınayın. "Bağlandı" ve "Kimlik bilgisi gönderildi." görene kadar formu düzeltin.
- Bir akışta dış istek adımı kurup gerçek bir yolla deneyin.
- Çalıştığından emin olunca kapsamı Tüm hesaplar yapın.
Sık yapılan hatalar
Kimlik başlığını "Varsayılan başlıklar" listesine yazmak. Kimlik için ayrı bir bölüm var; ikisini birden yazmak isteği bozar.
Temel adrese yolu da yazmak. https://api.ornek.com/v1/siparis yazıp adımda yine /siparis yazarsanız adres iki kez yol alır.
http:// ile adres yazmak. Adres https ile başlamalıdır.
Anahtarı kaydettikten sonra okumaya çalışmak. Bir daha gösterilmez.
Denemeden canlıya almak. Dene düğmesi bir dakikanızı alır ve saatlerce sürecek bir hata avını önler.
Bağlantıyı silip akışları kontrol etmemek. Silinen bağlantıyı kullanan adımlar çalışmaz; yapay zekâ anahtarlarında olduğu gibi bir yedek yoktur.
Kapsamı "Seçilen hesaplar" yapıp hiç hesap işaretlememek. Bağlantı hiçbir yerde kullanılmaz.
İlgili kavramlar
Dış istek adımının nasıl kurulduğu için Akış adımları bölümüne bakın. Hesap taşındığında bağlantılara ne olduğunu Hesabı başka portföye taşıma, yapay zekâ anahtarlarındaki benzer kapsam mantığını Yapay zekâ anahtarları rehberinde bulabilirsiniz.
Bu makale yardımcı oldu mu?