Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

Sağlık ve Hazırlık Kontrolleri

Bu üç GET endpointi kimlik doğrulama gerektirmez ve /api/v1 dışında çalışır. Başarı zarfı kullanılmaz; alanlar doğrudan JSON kökünde döner. Örnekler şemayı gösterir; sourceCommit dağıtıma göre değişir.

curl https://api.mevzuatradar.com/health curl https://api.mevzuatradar.com/health/live curl https://api.mevzuatradar.com/health/ready

GET /health

DB’de SELECT 1 ve Redis’te PING kontrolü yapar. İkisi de başarılıysa status: "ok", herhangi biri başarısızsa status: "degraded" döner. Controller bu sonuca göre HTTP durumunu değiştirmez: bağımlılık arızası normal kontrol akışında HTTP 200 ile de bildirilebilir. Hazır olma kararı için yalnız bu endpointin HTTP durumuna bakılmaz.

{ "status": "ok", "db": true, "redis": true, "sourceCommit": "cdf2db14e98f3455d503e0b918d1fb83c5738860" }

GET /health/live

Süreç canlılığını bildirir. DB, Redis, Meilisearch veya MinIO bağlantısını kontrol etmez. Handler çalışabildiğinde HTTP 200 ve şu gövde döner:

{ "status": "ok", "live": true, "reason": "process_alive", "sourceCommit": "cdf2db14e98f3455d503e0b918d1fb83c5738860" }

Bağımlılık arızası tek başına süreç yeniden başlatma kararı olarak kullanılmamalıdır. Ağ veya erişim ara katmanındaki hata yine isteğin handler’a ulaşmasını engelleyebilir.

GET /health/ready

DB, Redis, Meilisearch ve MinIO kontrolleri paralel yürütülür. Dördü de başarılıysa HTTP 200, herhangi biri başarısızsa HTTP 503 döner. Meilisearch ve MinIO HTTP kontrollerinin her biri 450 ms zaman aşımına sahiptir. DB ve Redis için bu metotta ayrı 450 ms sınırı yoktur; bağlantı sürücülerinin davranışı geçerlidir. Toplam yanıt süresi 450 ms garanti edilmez.

{ "status": "ok", "ready": true, "checks": { "db": true, "redis": true, "meilisearch": true, "minio": true }, "reason": "ok", "sourceCommit": "cdf2db14e98f3455d503e0b918d1fb83c5738860" }

Başarısız kontrol örneği (HTTP 503):

{ "status": "degraded", "ready": false, "checks": { "db": false, "redis": true, "meilisearch": true, "minio": true }, "reason": "db_down", "sourceCommit": "cdf2db14e98f3455d503e0b918d1fb83c5738860" }

reason, başarısız kontroller arasında şu öncelikle seçilir: db_down, redis_down, meilisearch_down, minio_down. Bütün sonuçlar checks içinde görünür. Mevcut sağlık servisi bu karara drainPhase: "idle" geçirir; bu endpoint süreç kapatma aşamasını dinamik olarak izlediğini garanti etmez. 503 gövdesi yukarıdaki sağlık şemasını korur; Problem Details değildir.

Kod Kimliği ve Yorumlama Sınırı

sourceCommit, SOURCE_COMMIT yapılandırmasının başındaki ve sonundaki boşlukları temizlenmiş değeridir; boşsa veya tanımsızsa null döner. Endpoint Git deposunu sorgulamaz ve değerin geçerli SHA olduğunu doğrulamaz. Dağıtım doğrulamasında beklenen commit ile ayrıca karşılaştırılır. /health.sourceCommit ifadesi gövdedeki alana işaret eder; ayrı URL değildir.

24 Ekim 2026 19:23 UTC kimliksiz GET gözleminde üç endpoint de HTTP 200 ve yukarıdaki commit değerini döndürmüştür. Bu, tarihli API gözlemidir; başka servislerin aynı committe olduğunu veya bir sonraki dağıtımın başarısını kanıtlamaz.

Sağlık şeması bağlantı dizesi, gizli anahtar veya ham bağımlılık hata mesajı döndürmez. Hazırlık kontrolü erişilebilirlik ölçer; arşiv tamlığı, veri kalitesi, bütün iş kuyrukları veya tüm ürün işlevleri için kabul testi değildir.