Recursos · Referencia de API

Referencia de API

Referencia completa de cada endpoint de OpenQCore, agrupada por superficie de runtime y capa de ejecución.

Catálogo de API

Un índice rápido orientado a la ejecución. El comportamiento técnico detallado está en cada página de API dedicada.

Autenticación

POST /auth/login

POST /auth/refresh

Autenticación, claves API, gestión de ámbitos y control de acceso.

[Ver documentación de autenticación]

Claves API

POST /api-keys

GET /api-keys

POST /api-keys/{key_id}/revoke

POST /api-keys/{key_id}/disable

Crear, listar, revocar y deshabilitar claves API personales utilizadas para la autenticación no interactiva.

Ver referencia de claves API →

Runtime de chat

GET /chat/health

POST /chat/completions

Ejecución conversacional central, streaming, persistencia y controles de tiempo de ejecución.

[Ver API de chat]

Sesiones de chat y mensajes

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}

Crear, listar, renombrar, fijar/destacar y eliminar sesiones de chat; editar un mensaje con historial rastreado, deshacer la última edición o eliminar un mensaje.

Ver la API de Sesiones y Mensajes →

Runtime de voz

POST /voice/chat

POST /voice/chat/meta

POST /voice/interrupt/{session_id}

WS /voice/ws

STT en tiempo real, LLM, TTS, manejo de interrupciones y audio en streaming.

[Ver API de voz]

Iris multimodal

POST /iris/generate

POST /iris/video

POST /iris/ocr

POST /iris/verify

Imágenes, video, OCR y flujos de trabajo multimodales.

[Ver la API de Iris]

Conocimiento

GET /console/knowledge

POST /console/knowledge

POST /console/knowledge/upload

POST /console/knowledge/ask

PATCH /console/knowledge/{id}

DELETE /console/knowledge/{id}

Ingesta y recuperación de conocimiento, y ejecución aumentada mediante recuperación.

[Ver la API de Conocimiento]

Archivo

POST /archive/units

GET /archive/units

GET /archive/units/{unit_id}

PATCH /archive/units/{unit_id}

DELETE /archive/units/{unit_id}

Crear, listar, recuperar, actualizar y eliminar unidades de conocimiento archivadas asociadas a un usuario o espacio de trabajo.

Ver la API de Archivo →

Encabezados en tiempo de ejecución

Referencia rápida de los encabezados requeridos en las distintas superficies de tiempo de ejecución.

Encabezado	Obligatorio
`Authorization`	✅
`X-API-Key`	Alternativa a la cabecera Authorization
`X-Scope-Type`	✅
`X-Workspace-ID`	Solo espacio de trabajo
`X-Agent-ID`	Opcional

Códigos de respuesta

Clases comunes de respuestas operativas.

Código	Significado
200	Éxito
400	Solicitud incorrecta
401	No autorizado
403	Prohibido
409	Conflicto de bloqueo
422	Error de validación
429	Límite de tasa excedido
503	Sobrecargado

Estadísticas de la plataforma

Una instantánea operativa de alto nivel.

Puntos finales

Entornos de ejecución

Integraciones de proveedores

Unificado

Contrato de salida

Dual

Transmisión + No transmisión