API Reference

API Reference

Documentazione delle API REST per l’integrazione con Corellix.

Base URL

https://api.corellix.io/api/v1

Autenticazione

Tutte le richieste richiedono un Bearer Token:

Authorization: Bearer YOUR_ACCESS_TOKEN

Endpoints

Sessions

GET /sessions

Recupera l’elenco delle sessioni.

Query Parameters:

Param	Type	Description
status	string	Filter by status (active, disconnected, all)
deliveryGroup	string	Filter by delivery group
from	datetime	Start date
to	datetime	End date
page	int	Page number
pageSize	int	Items per page (max 100)

Response:

{
  "data": [
    {
      "id": "sess-123",
      "userName": "DOMAIN\\user",
      "machineName": "VDI-001",
      "deliveryGroup": "Windows 11",
      "status": "Active",
      "startTime": "2025-12-19T08:30:00Z",
      "clientAddress": "192.168.1.100"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "total": 150
  }
}

---

Applications

GET /applications

Recupera il catalogo delle applicazioni.

Response:

{
  "data": [
    {
      "id": "app-456",
      "name": "Microsoft Word",
      "processPath": "C:\\Program Files\\Microsoft Office\\...",
      "icon": "base64...",
      "usageCount": 1250
    }
  ]
}

GET /applications/{id}/usage

Statistiche di utilizzo per un’applicazione specifica.

---

Machines

GET /machines

Elenco delle macchine monitorate.

Query Parameters:

Param	Type	Description
catalog	string	Filter by machine catalog
status	string	Filter by power state

---

Reports

POST /reports

Crea un nuovo report.

Request Body:

{
  "name": "Weekly Usage Report",
  "type": "session-summary",
  "dateRange": {
    "from": "2025-12-12T00:00:00Z",
    "to": "2025-12-19T23:59:59Z"
  },
  "filters": {
    "deliveryGroups": ["Windows 11", "Windows 10"]
  },
  "format": "pdf"
}

GET /reports/{id}

Recupera lo stato e il download link di un report.

---

Error Responses

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired token",
    "details": null
  }
}

Code	HTTP Status	Description
UNAUTHORIZED	401	Token non valido
FORBIDDEN	403	Permessi insufficienti
NOT_FOUND	404	Risorsa non trovata
RATE_LIMITED	429	Troppe richieste
SERVER_ERROR	500	Errore interno

SDK

• .NET SDK
• Python SDK (coming soon)
• PowerShell Module (coming soon)