Referans
#Yönetim API'si
Konsolun kullandığı API. Bütün uçlar /admin/v1/ altındadır, konsol oturumu gerektirir ve oturumun bağlı olduğu kurumla sınırlıdır; istek gövdesinden kurum seçilemez. ADMIN_SESSION_SECRET boşsa bütün uçlar 401 döner.
Hatalar OpenAI biçimindedir: {"error": {"message": "...", "type": "..."}}.
#Oturum
| Uç | Gövde / sorgu | Döner |
|---|
POST /session | {email, password} | Oturum çerezi (HttpOnly) |
GET /session | — | Oturumdaki e-posta ve kurum |
DELETE /session | — | Çerezi siler |
Betiklerde: giriş yapıp set-cookie başlığını saklayın, sonraki isteklerde --cookie ile gönderin.
#Denetim kaydı
| Uç | Sorgu | Döner |
|---|
GET /audit/records | part=YYYY-MM (varsayılan bu ay), limit (en çok 500), before_seq | {part, records[], page: {limit, returned, next_before_seq}}. Yeniden eskiye sayfalar; next_before_seq null olana kadar tekrarlayın |
GET /audit/verify | part, from_seq (varsayılan 1), to_seq | {part, requested, anchored_to, ok, checked, problems[]} — zincir doğrulaması, sunucu tarafında |
Kayıtlar kayıt şeması biçimindedir; _id alanı özet hesabına dahil değildir.
#Kanıt paketi
| Uç | Sorgu | Döner |
|---|
GET /exports/kvkk | part=YYYY-MM ya da period=week|month|year + value; format=pdf|json (varsayılan pdf) | Dosya (content-disposition: attachment) |
#Politika
| Uç | Gövde | Not |
|---|
GET /policy | — | Politika, paket sürümü ve her seçeneğin açıklama metinleri |
PUT /policy | Politikanın tamamı: detection_mode, pii_action, buffered_output, injection_action, rate_limit_per_minute, allowed_models, allowed_tools, monthly_token_budget, key_monthly_token_budget | Belge bütünüyle değiştirilir; eksik alan 400 döner. hold, parmak izi anahtarı tanımlı değilse reddedilir |
#Anahtarlar
| Uç | Gövde | Not |
|---|
GET /keys | — | Liste; anahtarın kendisi yoktur |
POST /keys | {label?, purpose?, legal_basis?} | Anahtar yalnız bu yanıtta görünür |
PUT /keys/:keyId/purpose | {purpose, legal_basis} (ikisi de null olabilir) | |
POST /keys/:keyId/revoke | — | Kayıt silinmez |
#Sağlayıcılar
| Uç | Gövde | Not |
|---|
GET /secrets | — | Kasadaki sır adları ve tarihleri; değerler asla |
PUT /secrets/:name | {value} | Şifrelenir; bir daha okunamaz |
DELETE /secrets/:name | — | |
GET /targets | — | Hedefler ve her biçim için seçim sırası |
PUT /targets/:name | {api_style, base_url, region, declared?, auth_kind, secret_ref | secret_env, model_patterns?, default?, enabled?, azure?: {api_version, deployments?}} | Oluşturur ya da günceller |
POST /targets/:name/enabled | {enabled} | |
DELETE /targets/:name | — | |
#Uyarılar ve onay
| Uç | Gövde | Not |
|---|
GET /alerts | — | Son 200 uyarı ve ayarlar; webhook adresi yalnız ana makine adıyla |
GET /alert-settings | — | |
PUT /alert-settings | {steps: [...] | ["*"] | null, webhook_url: "https://..." | "__keep__" | null} | "__keep__" saklı adresi korur; adres bir daha gösterilmediği için gerekir |
POST /holds/approve | {part, seq} | Bekletilen kaydı onaylar. Parmak izi istekten değil kayıttan okunur; yalnız gerçekten bekletilmiş bir istek onaylanabilir |
#Sağlık ve metrik
Oturum gerektirmeyen iki uç /admin dışındadır: GET /healthz, GET /readyz ve jetonla GET /metrics. Bkz. İzleme.