Ana içeriğe atla
Poliçelerden hata fırlatıldığında Apinizer, kullanıcıya özelleştirilme yapılmamış ise varsayılan hata mesajını gönderir. Hata mesajı/mesajlarının özelleştirilmesi hem Apinizer genelinde uygulanması hem de ilgili poliçede uygulanması baz alınarak yapılır. Uygulama bazında tüm hata mesajları bu sayfa üzerinden yönetilebilmektedir.
Hata mesajı yapılandırmasının tüm katmanları, çalışma mantığı, öncelik sırası ve senaryo örnekleri için Hata Mesajı Yapılandırma Rehberi sayfasına bakın.

Hata Mesajı Öncelik Sırası

Bir hata oluştuğunda Gateway aşağıdaki öncelik sırasına göre hangi hata yanıtının döneceğini belirler:
Üst öncelikli bir kaynak tanımlıysa, alt öncelikliler değerlendirilmez. Örneğin bir hata satırı için özel mesaj şablonu aktifse, politika genelindeki şablon veya satır bazlı alan özelleştirmeleri dikkate alınmaz.
Politika ve İş Kuralı STOP aksiyonunda şablon tabanlı (dinamik) hata mesajları kullanarak serbest metin şablonu yazabilir ve #{error.defaultErrorCode}, #{request.uri}, #{message.correlationId} gibi yer tutucularla istek/hata bilgilerini otomatik dahil edebilirsiniz. Bu özelliğin detayı için Politika Nedir? — Hata Mesajı Özelleştirme bölümüne bakın.

Özelleştirilebilir Alanlar

Hata mesajındaki HTTP Durum Kodu, Hata Kodu ve Hata Mesajı alanları özelleştirilebilmektedir. Ekran üzerinden ilgili alanın hücresine tıklayarak özelleştirme yapılabilir.

Konfigürasyon Alanları

Satır Bazlı Özel Mesaj Şablonu

Tablodaki her hata satırında bulunan Özelleştir butonu ile o hata tipine özel bir mesaj şablonu tanımlanabilir. Bu, öncelik sırasındaki 1. seviye (en yüksek öncelik) olarak çalışır. Özelleştir butonuna tıklandığında açılan diyalogda:
Satır bazlı özel mesaj şablonu aktif edildiğinde, aynı hata tipi için platform genelindeki özelleştirmeler (bu sayfadaki özelleştirilmiş alanlar) değerlendirilmez. Şablon en yüksek önceliğe sahiptir.
Bu sayfa platform genelindeki hata mesajı özelleştirmesini yönetir (Öncelik sırasında 5. seviye). Politika bazlı satır bazlı özel mesaj şablonu ve alan özelleştirmesi gibi daha yüksek öncelikli yöntemler politika güncelleme ekranında yapılır. Detaylar için Politika Nedir? — Hata Mesajı Özelleştirme sayfasına bakın.

Hata Yanıt Kuralları (Error Response Rules)

Her hata satırı için birden fazla yanıt kuralı tanımlayarak, istek bilgilerine göre farklı hata yanıtları döndürebilirsiniz. Kurallar koşul bazlı çalışır; istek yolu, başlık değerleri, HTTP metodu gibi kriterlere göre eşleşme yapılır.

Kuralların Çalışma Mantığı

  1. Hata oluştuğunda tanımlanan kurallar sıra numarasına göre değerlendirilir
  2. İlk eşleşen kuralın şablonu uygulanır
  3. Hiçbir kural eşleşmezse sonraki öncelik seviyesine geçilir
  4. Koşulsuz bir kural varsayılan kural (catch-all) olarak çalışır
Özel mesaj oluşturucu aktifken: Aynı hata satırı için özel mesaj oluşturucu (Custom Message Builder) etkin ise, hata yanıt kuralları değerlendirilmez. Özel mesaj oluşturucu en yüksek önceliğe sahiptir.

Kural Listesi

Özelleştir butonuna tıklandığında açılan diyalogda, hata yanıt kuralları tablosu üst bölümde yer alır: Kurallar arasında sıralama yukarı/aşağı ok butonları ile değiştirilebilir. Her kural düzenlenebilir veya silinebilir. Lisans Bilgileri

Kural Düzenleme

Yeni kural eklerken veya mevcut kuralı düzenlerken açılan diyalogda: Lisans Bilgileri

Şablonda Kullanılabilir Değişkenler

Mesaj şablonunda aşağıdaki yer tutucu ve değişkenler kullanılabilir:
${DEGISKEN_ADI} formatında ortam değişkenleri kullanılabilir. Ortam değişkenleri hakkında detaylı bilgi için Ortam Değişkenleri sayfasına bakın.

Politika ve Yönlendirme Bazlı Kurallar

Hata yanıt kuralları yalnızca bu sayfadan (platform genelinde) değil, aynı zamanda politika ve yönlendirme yapılandırmasındaki hata mesajı bölümünden de tanımlanabilir.
Politika veya yönlendirme seviyesinde tanımlanan hata yanıt kuralları, platform genelindeki kuralların üzerine yazılır. Bu sayede belirli bir politika veya yönlendirme için özel hata yanıt davranışı tanımlanabilir.

Hata Tipi, Hata Kodu ve Hata Mesajları Tablosu

Önemli Notlar

API Proxy Yanıtları: API Proxy yanıtlarında dönen mesajlarda Hata Üst Tipi ve Hata Tipi alanları yer almamaktadır. Log Mesajları: Bu iki alan (Hata Üst Tipi ve Hata Tipi) mesaj trafiğinin kayıt edildiği JSON mesajlarında yer almaktadır. Daha detaylı bilgi için [Log Ayarları] menüsünde yer alan [Örnek Mesaj Veri Yapısı] sayfasını ziyaret edebilirsiniz.

Hata Üst Tipi Değerleri Tablosu

Sonuç Tipi Değerleri Tablosu