i18n — Blesyum Core API

GET/api/v1/i18n/{namespace}/{locale}

GET /api/v1/i18n/{namespace}/{locale} — PUBLIC. Bir sözlük parçası.

OturumYol parametresi: namespacelocale

Kiracıya göre DEĞİŞMEZ (2026-08-19 kararı: çeviri platformundur). Bu, ucu tamamen önbelleklenebilir kılar — marka ucundan farklı olarak host çözümü YOK. Önbellek: istemci `?v=<sürüm>` ile ister ve yanıt `immutable` gelir. Sürüm `core.i18n_versions`ten türer; çeviri düzeltilince artar. Sürümsüz istek de çalışır ama kısa ömürlü önbelleklenir — ilk açılışta sürüm henüz bilinmez.

İstek

curl -X GET "https://api.blesyum.com/api/v1/i18n/<namespace>/<locale>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/v1/i18n/locales

Sunucu saati — PUBLIC, oturum istemez, veritabanına HİÇ gitmez.

Oturum

İki işi birden yapar ve bu yüzden ayrı iki uç açılmamıştır: 1. **Saat referansı.** Panel, cihaz saatinin sapmasını ölçüp kullanıcıya söyler (frontend `lib/clock.ts`). Sapma yalnız kozmetik değildir: >45 sn kaymış bir cihazın TOTP kodu reddedilir ve kullanıcı bunu "2FA bozuk" diye okur. 2. **Bağlantı yoklaması.** Kesintide panel bu ucu geri-çekilmeli olarak yoklar (frontend `lib/connection.ts`). Kenarın `/healthz`'i bu soruyu yanıtlamaz: Caddy ayakta, arkadaki auth ölü olabilir — bu uç yanıt veriyorsa panelin gerçekten konuştuğu servis ayaktadır. 🔴 Gövde KASITLI olarak minik ve DB'siz: kesinti sırasında saniyede birden çok istemci tarafından yoklanır; zaten zorlanan bir sisteme yük bindirmemeli. GET /api/v1/i18n/locales — **PUBLIC**. Platformun sunduğu diller. PUBLIC olmak ZORUNDA: giriş ekranının da dil seçicisi vardır ve oturum açmadan önce dil seçebilmek, kullanıcının paneli okuyabilmesinin ön koşuludur. `core.languages` (mig 0023) yerine `core.locales` okunur: eskisi yalnız code/name/enabled taşıyordu, yön (rtl) ve fallback zinciri yoktu.

İstek

curl -X GET "https://api.blesyum.com/api/v1/i18n/locales" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET /api/v1/i18n/{namespace}/{locale} — **PUBLIC**. Bir sözlük parçası.

Sunucu saati — **PUBLIC**, oturum istemez, veritabanına HİÇ gitmez.

GET /api/v1/i18n/{namespace}/{locale} — PUBLIC. Bir sözlük parçası.

Sunucu saati — PUBLIC, oturum istemez, veritabanına HİÇ gitmez.