Referinta API

API-ul RESTful pentru integrarea agentilor VAI in aplicatiile tale.

Autentificare

Toate request-urile trebuie sa includa header-ul de autorizare:

Authorization: Bearer vai_sk_live_xxxxxxxxxxxx

URL de baza

https://api.vai-portal.ro/api/v1

Rate Limiting

API-ul permite maxim 100 request-uri pe minut per cheie API. Header-ele de raspuns includ informatii despre limita curenta.

Endpoint-uri

POST/api/v1/chat

Trimite un mesaj catre un agent AI

Parametri:

Nume	Tip	Obligatoriu	Descriere
`agentId`	string	Da	ID-ul agentului
`message`	string	Da	Mesajul utilizatorului
`sessionId`	string	Da	ID unic pentru sesiune
`context`	object	Nu	Date aditionale de context

GET/api/v1/agents

Listeaza toti agentii disponibili

GET/api/v1/agents/:id

Obtine detalii despre un agent specific

Parametri:

Nume	Tip	Obligatoriu	Descriere
`id`	string	Da	ID-ul agentului

GET/api/v1/sessions/:sessionId

Obtine istoricul unei conversatii

Parametri:

Nume	Tip	Obligatoriu	Descriere
`sessionId`	string	Da	ID-ul sesiunii

DELETE/api/v1/sessions/:sessionId

Sterge o sesiune si istoricul ei

Parametri:

Nume	Tip	Obligatoriu	Descriere
`sessionId`	string	Da	ID-ul sesiunii

GET/api/v1/usage

Obtine statistici de utilizare

Parametri:

Nume	Tip	Obligatoriu	Descriere
`from`	date	Nu	Data de inceput
`to`	date	Nu	Data de sfarsit

Exemplu de raspuns

{
  "success": true,
  "data": {
    "id": "msg_xxxxx",
    "text": "Pentru a reseta parola...",
    "agentId": "suport-it",
    "sessionId": "user-123",
    "tokensUsed": 15,
    "createdAt": "2026-01-30T10:00:00Z"
  }
}

Coduri de eroare

Cod	Descriere
400	Request invalid - parametri lipsa sau incorecti
401	Neautorizat - cheie API invalida
403	Interzis - nu ai acces la aceasta resursa
404	Negasit - resursa nu exista
429	Prea multe request-uri - rate limit depasit
500	Eroare server - incearca din nou