Skip to main content

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.


Analitik cache​

GET /analytics/{org_id}/cache?from=&to=​

Dapatkan kadar hit cache dan analitik penjimatan setiap organisasi.

Parameter pertanyaan:

  • from: Masa mula (RFC3339, lalai: 24 jam lalu)
  • to: Masa tamat (RFC3339, lalai: sekarang)

Respons: 200 OK

{
"total_requests": 1000,
"hits_exact": 350,
"hits_semantic": 150,
"misses": 500,
"cache_hit_rate": 0.5,
"savings_usd": 2.45,
"counterfactual_cost_usd": 4.90,
"avg_similarity": 0.973
}

Eksperimen A/B​

POST /cache/experiments​

Cipta eksperimen cache baharu. Pentadbir root sahaja.

Permintaan:

{
"name": "cache-ab-test-1",
"org_id": "abc-123",
"traffic_pct": 50
}

Respons: 201 Created — Objek eksperimen dengan penetapan berketentuan.

GET /cache/experiments?org_id=&enabled=​

Senaraikan eksperimen. Parameter pertanyaan pilihan: org_id, enabled=true.

Respons: 200 OK — Tatasusunan objek eksperimen.

GET /cache/experiments/{exp_id}/results​

Dapatkan penjimatan setiap varian bagi satu eksperimen.

Respons: 200 OK

{
"control_savings_usd": 0.50,
"treatment_savings_usd": 1.20
}

Respons ralat​

StatusKodPenerangan
400invalid_requestJSON cacat atau mod tidak sah
403permission_deniedPentadbir bukan root pada endpoint root sahaja
404not_foundOrganisasi/model/eksperimen tidak dijumpai
500internal_errorRalat pangkalan data atau kegagalan perkhidmatan cache