Referans
API referansı
Ağ geçidi ve panel tarafından kullanılan başlıca uç noktalar. Tüm istekler JSON'dur.
Kimlik doğrulama
Programatik erişim için Authorization: Bearer ag_live_… başlığı. Panel için oturum çerezi.
Ağ geçidi
GET /api/gateway/resolve
Bir ajanın politikasını döndürür.
GET /api/gateway/resolve
Authorization: Bearer ag_live_xxx
X-Agent-Key: agk_xxx
{
"agentId": "…",
"agentKey": "agk_xxx",
"name": "support-agent-v1",
"orgId": "…",
"policyYaml": "agent: support-agent-v1\n…"
}
| Kod | Anlam |
|---|---|
| 400 | agentKey eksik. |
| 404 | Böyle bir ajan yok (ya da başka tenant'ta). |
| 403 | Ajan duraklatıldı. |
POST /api/events/ingest
Maskelenmiş denetim olaylarını gönderir. Gövde: { "events": [...] }, { "event": {...} } veya doğrudan dizi. En çok 100 olay / istek.
Olaylar
| Uç nokta | Açıklama |
|---|---|
GET /api/events | Olay listesi (süzülebilir). |
GET /api/events/stats | Özet sayılar. |
GET /api/events/sessions | Oturum özetleri. |
GET /api/events/timeseries | Zaman serisi. |
GET /api/events/insights | Öngörüler. |
GET /api/events/:correlationId | Tek bir çağrının tüm ayrıntısı. |
Politika
| Uç nokta | Açıklama |
|---|---|
GET /api/policy | Geçerli politika. |
POST /api/policy/validate | YAML'ı kaydetmeden doğrula. |
PUT /api/policy | Politikayı kaydet. |
Yönetim
| Uç nokta | Açıklama |
|---|---|
GET/POST/PUT/DELETE /api/agents | Ajan kayıtları. |
GET/POST/DELETE /api/settings/keys | API anahtarları. |
GET /api/status | Sistem durumu. |
NotUç noktalar tenant'a göre sınırlandırılmıştır ve hız sınırlama uygulanır.