Risorse · Riferimento API

Riferimento API

Riferimento completo per ogni endpoint di OpenQCore, raggruppato per superficie di runtime e livello di esecuzione.

Catalogo API

Un indice veloce orientato all'esecuzione. Il comportamento tecnico dettagliato è documentato in ciascuna pagina API dedicata.

Autenticazione

POST /auth/login

POST /auth/refresh

Autenticazione, chiavi API, gestione degli ambiti e controllo degli accessi.

[View Authentication Docs]

Chiavi API

POST /api-keys

GET /api-keys

POST /api-keys/{key_id}/revoke

POST /api-keys/{key_id}/disable

Crea, elenca, revoca e disabilita chiavi API personali utilizzate per l'autenticazione non interattiva.

Visualizza il riferimento delle Chiavi API →

Runtime Chat

GET /chat/health

POST /chat/completions

Esecuzione conversazionale di base, streaming, persistenza e controlli di runtime.

[View Chat API]

Sessioni di chat e messaggi

POST /sessions

GET /sessions

GET /sessions/{session_id}/messages

PATCH /sessions/{session_id}

DELETE /sessions/{session_id}

GET /messages/{message_id}

PATCH /messages/{message_id}

GET /messages/{message_id}/history

POST /messages/{message_id}/undo

DELETE /messages/{message_id}

Crea, elenca, rinomina, fissa/contrassegna con stella e elimina le sessioni di chat; modifica un messaggio con cronologia tracciata, annulla l'ultima modifica o elimina un messaggio.

Visualizza l'API Sessioni e Messaggi →

Runtime vocale

POST /voice/chat

POST /voice/chat/meta

POST /voice/interrupt/{session_id}

WS /voice/ws

STT in tempo reale, LLM, TTS, gestione delle interruzioni e audio in streaming.

[View Voice API]

Iris multimodale

POST /iris/generate

POST /iris/video

POST /iris/ocr

POST /iris/verify

Immagini, video, OCR e flussi di lavoro multimodali.

[View Iris API]

Conoscenza

GET /console/knowledge

POST /console/knowledge

POST /console/knowledge/upload

POST /console/knowledge/ask

PATCH /console/knowledge/{id}

DELETE /console/knowledge/{id}

Ingestione, recupero ed esecuzione potenziata tramite retrieval.

[View Knowledge API]

Archivio

POST /archive/units

GET /archive/units

GET /archive/units/{unit_id}

PATCH /archive/units/{unit_id}

DELETE /archive/units/{unit_id}

Crea, elenca, recupera, aggiorna e elimina unità di conoscenza archiviate associate a un utente o a uno spazio di lavoro.

Visualizza l'API Archivio →

Intestazioni runtime

Riferimento rapido per le intestazioni richieste nelle varie superfici runtime.

Intestazione	Richiesto
`Authorization`	✅
`X-API-Key`	Alternativa all'Authorization
`X-Scope-Type`	✅
`X-Workspace-ID`	Solo per l'area di lavoro
`X-Agent-ID`	Opzionale

Codici di risposta

Classi di risposta operative comuni.

Codice	Significato
200	Successo
400	Richiesta non valida
401	Non autorizzato
403	Vietato
409	Conflitto di blocco
422	Errore di validazione
429	Limite di velocità superato
503	Sovraccarico

Statistiche della piattaforma

Una panoramica operativa ad alto livello.

Endpoint

Ambienti di runtime

Integrazioni dei provider

Unificato

Contratto di output

Duale

Streaming + Non streaming