Skip to main content

​
API Proxy Client Route Kullanım Kılavuzu

Client Route Genel Bakış

Client Route Genel Bakış

​
Genel Bakış

Apinizer’ın Client Route özelliği, API Gateway’de gelen isteklerin daha esnek ve dinamik bir şekilde yönlendirilmesini sağlar. Bu özellik sayesinde:
  • Bir proxy’e birden fazla relative path tanımlanabilir
  • Host bilgisine göre farklı proxy’lere yönlendirme yapılabilir
  • HTTP header değerlerine göre yönlendirme kuralları oluşturulabilir
  • Method bazlı yönlendirme yapılabilir
Bu özellik geliştirilmeden önce, her proxy için yalnızca tek bir benzersiz (unique) relative path tanımlanabiliyordu. Yeni özellik ile aynı relative path’e sahip birden fazla proxy oluşturulabilir ve bunlar arasında host, header veya method bilgilerine göre dinamik yönlendirme yapılabilir.

​
Client Route Nasıl Çalışır?

Client Route özelliği, gelen istekleri belirli bir öncelik sırasına göre değerlendirerek doğru proxy’e yönlendirir.

​
Yönlendirme Öncelik Sırası

Gateway, gelen istekleri aşağıdaki öncelik sırasına göre değerlendirir:
  1. Relative Path (En yüksek öncelik)
  2. Hosts
  3. Headers
  4. Methods (En düşük öncelik)

​
Eşleştirme Mantığı

  • Hosts: Birden fazla host tanımlandığında OR mantığı ile çalışır. Yani tanımlanan hostlardan herhangi birinin eşleşmesi yeterlidir.
  • Headers: Birden fazla header tanımlandığında AND mantığı ile çalışır. Yani tanımlanan tüm header’ların eşleşmesi gerekir.

​
Wildcard Hostname Kullanımı

Apinizer, host tanımlamalarında esneklik sağlamak için wildcard (joker karakter) kullanımını destekler. Wildcard hostname’ler, belirli bir pattern’e uyan tüm Host header değerlerinin koşulu sağlamasına ve böylece ilgili Route ile eşleşmesine olanak tanır.

​
Wildcard Kuralları

Wildcard hostname’ler aşağıdaki kurallara uygun olmalıdır:
  • Domain’in en solundaki veya en sağındaki label’ında yalnızca bir adet asterisk (*) içerebilir
  • Asterisk, domain’in başında veya sonunda kullanılabilir

​
Wildcard Örnekleri

​
Sol Taraf Wildcard

Bu tanımlama aşağıdaki Host değerlerinin eşleşmesini sağlar:
  • a.example.com
  • x.y.example.com
  • api.example.com
  • test.subdomain.example.com

​
Sağ Taraf Wildcard

Bu tanımlama aşağıdaki Host değerlerinin eşleşmesini sağlar:
  • example.com
  • example.org
  • example.net
  • example.io

​
Örnek Senaryo

Aşağıdaki tabloda 5 farklı proxy ve bunlara tanımlanmış Client Route yapılandırmaları gösterilmektedir.

​
Yönlendirme Örnekleri

Bu yapılandırmaya göre gelen istekler şu şekilde yönlendirilir:

​
Örnek 1: Temel Yönlendirme

İstek:
Sonuç: Proxy 5’e yönlendirilir (herhangi bir koşul sağlanmadığı için varsayılan proxy)

​
Örnek 2: Host Bazlı Yönlendirme

İstek:
Sonuç: Proxy 2’ye yönlendirilir (host koşulu sağlandı)

​
Örnek 3: Eksik Header ile Yönlendirme

İstek:
Sonuç: Proxy 5’e yönlendirilir (Proxy 1 için her iki header gerekli, sadece biri sağlandı)

​
Örnek 4: Tam Header Eşleşmesi

İstek:
Sonuç: Proxy 1’e yönlendirilir (tüm header koşulları sağlandı)

​
Örnek 5: Path Önceliği - Temel Path

İstek:
Sonuç: Proxy 4’e yönlendirilir (path tam eşleşme)

​
Örnek 6: Path Önceliği - Uzun Path

İstek:
Sonuç: Proxy 3’e yönlendirilir (daha spesifik path öncelikli)

​
Örnek 7: Path ile Alt Yol

İstek:
Sonuç: Proxy 3’e yönlendirilir (en yakın parent path eşleşmesi)

​
Örnek 8: Path Eşleşmesi - Farklı Alt Yol

İstek:
Sonuç: Proxy 4’e yönlendirilir (parent path olarak /jokes1 eşleşti)

​
Örnek 9: Host ve Header Kombinasyonu

İstek:
Sonuç: Proxy 2’ye yönlendirilir (host, header’dan daha yüksek önceliğe sahip)

​
Önemli Notlar

​
Path Eşleştirme

  • Relative path eşleştirmesi en yüksek önceliğe sahiptir.
  • Daha spesifik (uzun) path’ler, daha genel (kısa) path’lerden önce değerlendirilir.
  • Tam eşleşme bulunamazsa, en yakın parent path kullanılır.

​
Host Eşleştirme

  • Birden fazla host tanımlanabilir.
  • Hostlar OR mantığı ile çalışır.
  • İstekteki host değeri, tanımlanan hostlardan herhangi biriyle eşleşirse koşul sağlanır.

​
Header Eşleştirme

  • Birden fazla header tanımlanabilir.
  • Header’lar AND mantığı ile çalışır.
  • İstekte tanımlanan tüm header’lar mevcut olmalıdır.
  • Eksik veya hatalı header durumunda bir sonraki uygun proxy’ye geçilir.

​
Method Eşleştirme

  • Method kontrolü en düşük önceliğe sahiptir.
  • Belirtilmezse tüm HTTP methodları kabul edilir.
Client Route özelliği, API Gateway’inizde karmaşık yönlendirme senaryolarını kolayca yönetmenizi sağlar. Öncelik sırası ve eşleştirme mantığını doğru anlayarak, esnek ve güçlü API yönlendirme yapılandırmaları oluşturabilirsiniz.

​
Routing Kombinasyon Tablosu

Yok → API proxy tanımında bulunmamaktadır. Client’ın gönderdiği kontrol edilmez. Eşleşti → API proxy tanımında bulunmaktadır. Client’ın gönderdiği kontrol edilir, beklenen değeri gönderdi. Eşleşmedi → API proxy tanımında bulunmaktadır. Client’ın gönderdiği kontrol edilir, beklenen değeri göndermedi. Bu tablo API Proxy açısından, API Proxy nasıl seçilir bilgisini göstermektedir.