Rujukan API Pentadbir Cache
Semua endpoint memerlukan pengesahan pentadbir (token pembawa dengan peranan pentadbir). Laluan asas: /api.
Tetapan cache
GET /organizations/{id}/cache-settings
Dapatkan konfigurasi cache setiap organisasi.
Respons: 200 OK
{
"org_id": "abc-123",
"cache_enabled": true,
"cache_mode": "semantic"
}
PATCH /organizations/{id}/cache-settings
Kemas kini konfigurasi cache setiap organisasi. Pentadbir root sahaja.
Permintaan:
{
"cache_enabled": true,
"cache_mode": "exact"
}
Mod: off, exact, semantic
Pengesahan: Mod tidak sah → 400 Bad Request. Organisasi tiada → 404 Not Found. Bukan root → 403 Forbidden.
Operasi cache
POST /cache/flush?org_id=&model_tier=
Siram entri cache. Memerlukan org_id atau model_tier. Pentadbir root sahaja.
Respons: 200 OK — {"status": "flushed", "org_id": "...", "reason": "manual"}
GET /cache/analytics
Dapatkan analitik cache global (kadar hit, kiraan organisasi).
Respons: 200 OK — {"total_hits": {"exact": 1500, "semantic": 300}, "total_misses": 800, "org_count": 42}
POST /cache/warm (usang)
Dibuang. Pemanas menulis entri tidak bertandatangan yang sentiasa ditolak oleh carian RT-05; cache semantik hanya belajar daripada trafik langsung.
Respons: 410 Gone
POST /models/{name}/bump-version
Naikkan versi model untuk membatalkan kesahan cache. Pentadbir root sahaja.