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/readyGET /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.