REST API referenca
6 minPoslednja izmena: 2026-03-31
Autentifikacija
API zahtevi zahtevaju autentifikaciju putem JWT tokena ili API ključa:
Authorization: Bearer <jwt-token>
// ILI
X-API-Key: af_<32-hex-chars>
Chat endpoint
POST /api/v1/chat/{agentUuid}
Content-Type: application/json
{
"message": "Your question here",
"sessionId": "optional-session-id",
"stream": false
}
Odgovor:
{
"answer": "AI response text",
"sessionId": "uuid",
"tokensUsed": 142,
"sources": [{"text": "...", "score": 0.92}]
}
Widget chat (javni)
POST /api/v1/chat/{agentUuid}/widget
// Autentifikacija nije potrebna: Origin zaglavlje se proverava prema listi dozvoljenih domena
Agenti CRUD
POST /api/v1/agents - Kreiranje agenta
GET /api/v1/agents - Lista vaših agenata
GET /api/v1/agents/:id - Detalji agenta
PUT /api/v1/agents/:id - Izmena agenta
DELETE /api/v1/agents/:id - Brisanje agenta (soft)
Dokumenti
POST /api/v1/agents/:id/documents - Otpremanje fajla (multipart)
GET /api/v1/agents/:id/documents - Lista dokumenata
DELETE /api/v1/agents/:id/documents/:id: Brisanje dokumenta
Ograničenja broja zahteva
Globalno: 100 zahteva/minut. Auth: 10/minut. Chat: 30/minut.