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

*.example.com

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

example.*

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:

GET https://<ACCESS_URL>/jokes

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

Örnek 2: Host Bazlı Yönlendirme

İstek:

GET https://<ACCESS_URL>/jokes
Host: hostname_x.com

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

Örnek 3: Eksik Header ile Yönlendirme

İstek:

GET https://<ACCESS_URL>/jokes
testmode: true

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:

GET https://<ACCESS_URL>/jokes
testmode: true
test: true

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

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

İstek:

GET https://<ACCESS_URL>/jokes1

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

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

İstek:

GET https://<ACCESS_URL>/jokes1/endpoint_x

Sonuç: Proxy 3'e yönlendirilir (daha spesifik path öncelikli)

Örnek 7: Path ile Alt Yol

İstek:

GET https://<ACCESS_URL>/jokes1/endpoint_x/endpoint_y

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

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

İstek:

GET https://<ACCESS_URL>/jokes1/endpoint_y

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

Örnek 9: Host ve Header Kombinasyonu

İstek:

GET https://<ACCESS_URL>/jokes
Host: hostname_x.com
testmode: true
test: true

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

Örnek 10: Farklı Path ile Host ve Header

İstek:

GET https://<ACCESS_URL>/jokes1
Host: hostname_x.com
testmode: true
test: true

Sonuç: Proxy 4'e yönlendirilir (path önceliği en yüksek, host ve header'lar göz ardı edilir)

Ö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.