<!-- https://avertgate.com/tr/docs/api · 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.

<!-- request -->
```
GET /api/gateway/resolve
Authorization: Bearer ag_live_xxx
X-Agent-Key: agk_xxx
```

<!-- 200 OK -->
```
{
  "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. |

> **Not**: Uç noktalar tenant'a göre sınırlandırılmıştır ve hız sınırlama uygulanır.