Blesyum Core

docs

2 uç · /api/v1/docs

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 2 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

POST/api/v1/docs/feedback

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. POST /api/v1/docs/feedback — **PUBLIC**. Doküman sayfası geri bildirimi. # Neden oturumsuz apidocs.blesyum.com herkese açıktır; okuyucularının önemli bir kısmı henüz müşteri değildir. Giriş isteyen bir kutu, tam da duymamız gereken kitleyi susturur. # Mükerrer koruması SUNUCUDADIR İstemcideki localStorage işareti yalnız bir KOLAYLIKTIR (aynı sayfaya dönene "zaten oy verdin" demek için). İşareti silen biri yine ikinci kez oy veremez, çünkü kapı doc_feedback_visitor_uk unique indeksidir. (Aynı ders geçici-parola vakasında alınmıştı: *"paneldeki pencere çözüm değildi"*.) Karar ve SQL blesyum_site::dokumandadır — bu servis ham SQL yazmaz.

İstek
curl -X POST "https://api.blesyum.com/api/v1/docs/feedback" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/v1/docs/feedback/{slug}

GET /api/v1/docs/feedback/{slug} — **PUBLIC**. Bir sayfanın oy sayıları.

OturumYol parametresi: slug
İstek
curl -X GET "https://api.blesyum.com/api/v1/docs/feedback/<slug>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?