Skip to main content
La API REST de Horneross te permite integrar agentes de IA en cualquier aplicación.

​
Base URL

https://app.horneross.com/api

​
Autenticación

Todas las requests autenticadas requieren el header Authorization: 
Authorization: Bearer TU_API_KEY
Obtené tu API key en Settings → API Keys en el dashboard.

​
Endpoints disponibles

Chat

POST /v2/agent/{agentId}/chatEnviar mensajes y recibir respuestas de agentes

Datastores

GET/POST /datastoresGestionar bases de conocimiento y buscar documentos

Conversaciones

GET/PUT /v2/conversationsAcceder al historial y gestionar estados

Forms

GET/POST /forms/{formId}Recuperar formularios y enviar submissions

​
Formato de respuestas

Todas las respuestas están en formato JSON:

​
Respuesta exitosa

{
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100
  }
}

​
Respuesta de error

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key inválida o expirada",
    "details": {}
  }
}

​
Códigos de estado HTTP

CódigoSignificado
200Éxito
201Recurso creado
400Request inválida (parámetros incorrectos)
401No autenticado (API key faltante o inválida)
403Sin permisos para este recurso
404Recurso no encontrado
429Rate limit excedido
500Error interno del servidor

​
Rate Limits

Los límites de requests dependen de tu plan:
PlanRequests/minRequests/día
Free101,000
Starter6010,000
Pro300100,000
EnterprisePersonalizadoPersonalizado
Cuando excedés el rate limit, recibís un 429 Too Many Requests. Headers de rate limit en las respuestas: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640995200

​
Versionado

La API actual es v2. Los endpoints legacy (v1) siguen funcionando pero se recomienda migrar. 
# Recomendado (v2)
POST /api/v2/agent/{agentId}/chat

# Legacy (v1) - deprecated
POST /api/agents/{agentId}/query

​
SDKs oficiales

JavaScript

npm install @horneross/sdk

Python

pip install horneross

REST

Cualquier cliente HTTP

​
Soporte

Si encontrás problemas con la API: