Durum uçları

"API ayakta mı" sorusunu yanıtlayan dört uç var. Hiçbiri kimlik doğrulaması istemez ve hiçbiri data/meta zarfını kullanmaz — düz JSON dönerler.

Uç	Ne döner	Ne için
GET /health	statik durum	Basit erişilebilirlik kontrolü
GET /livez	{"status":"alive"}	Süreç ayakta mı. Bağımlılık kontrolü yapmaz — veritabanı düşse de alive döner
GET /readyz	hazırlık durumu	Trafik almaya hazır mı; veritabanı ve önbellek probu
GET /healthz	{"status":"ok"}	Erişilebilirlik — aşağıdaki nota bakın

/healthz sürüm bilgisi vermez

Dışarıdan çağrıldığında yanıt yalnız şudur

{ "status": "ok" }

Sürüm ve şema ayrıntısı yalnız Veni'nin izin listesindeki adreslere açılır. Yani "hangi sürüme bakıyorum" sorusunu buradan yanıtlamaya çalışmayın. Uç 404 değil 200 döner: kesinti izleyicileri ve yük dengeleyici probları çalışmaya devam etsin diye erişilebilirlik korunur, veri kısılır.

Yoklama sıklığı

Uç	Hız sınırı
GET /health · GET /livez · GET /readyz	Hiç uygulanmaz
GET /healthz	Kaynak IP başına genel (public) kovaya tabi

Prob yoklaması API kovanızdan çalmaz

/healthzin düştüğü genel kova ile /pos ve /b2b trafiğinizin kovası ayrı sayaçlardır: biri dolduğunda diğeri etkilenmez. Prob yoklamanız yüzünden POS çağrılarınızın 429 almasından endişelenmeniz gerekmez.

Yine de saniyede bir yoklamanın faydası yok: bu uçlar "API ayakta mı" sorusunu yanıtlar ve o yanıt saniyede bir değişmez. Dakikada birkaç istek yeterli.

Entegrasyonunuzun sağlığını ölçmek için daha iyi bir sinyal var: teslimat geçmişi (GET /api/v1/restaurants/me/webhooks/{id}/deliveries) ya da teslimat günlüğü bağlantısı. Prob uçları "API ayakta mı" der; teslimat geçmişi "benim entegrasyonum çalışıyor mu" der.