Integrare

E-Infra Knowledge API

Contract versionat · retrieval cu acces derivat din profil

Interogare din aplicație

Administratorul emite o cheie din Profiluri și acces → Chei API. Cheia este limitată la profilul respectiv.

1. Estimare fără apel la model

POST /v1/search/estimate
Authorization: Bearer <cheia-profilului>
Content-Type: application/json

{"query": "Cum pot transmite indexul?", "top_k": 8, "mode": "auto"}

Răspunsul include id, details.estimated_usd, maximum_usd și expires_at. Aprobarea se face de aplicația apelantă conform politicii sale.

2. Execuție după aprobarea costului

POST /v1/search
Authorization: Bearer <aceeași-cheie>
Content-Type: application/json

{"query": "Cum pot transmite indexul?", "top_k": 8, "mode": "auto", "quote_id": "<id-estimare>"}

Estimările expiră în 15 minute, sunt de unică folosință și sunt legate de cheie și parametri. Modificarea modelului, tarifului sau selecției necesită reestimare. Căutarea lexicală are cost extern zero.

Răspunsul conține request_id, mode, duration_ms, cost și results. Fiecare fragment include document_id, version_id, source_name, canonical_uri, locator, content și score.

Scorul este utilizat pentru ordonare, nu reprezintă probabilitatea de corectitudine. Endpointul livrează fragmente, fără generare LLM.

Erori uzuale

401: cheie absentă, revocată sau expirată. 409: estimare necesară, modificată, expirată sau reutilizată. 422: cerere invalidă ori estimare indisponibilă. 503: modelul de embeddings indisponibil. Un rezultat gol indică lipsa fragmentelor eligibile pentru cererea curentă.

Administrare

Rutele /api/* folosesc sesiunea utilizatorului și token CSRF pentru mutații. Cheile aplicațiilor nu acordă acces administrativ. Lista completă a rutelor și schemelor este disponibilă în contractul OpenAPI.

MCP, rate limits și identitatea delegată sunt planificate. Această versiune este destinată dezvoltării locale.