Skip to main content
La API de Horneross te permite integrar agentes de IA en tus propias aplicaciones, crear automatizaciones, y gestionar recursos programáticamente.

URL Base

https://app.horneross.com/api

Características principales

REST API

Endpoints HTTP estándar con JSON

Autenticación con API Keys

Tokens seguros para acceso programático

Rate Limiting

Límites según tu plan de suscripción

Webhooks

Notificaciones en tiempo real de eventos

Casos de uso

Integración en aplicaciones

Integrá agentes de Horneross directamente en tu aplicación web o móvil:
// Enviar mensaje a un agente
const response = await fetch('https://app.horneross.com/api/v2/agent/{agentId}/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tu_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: '¿Cuáles son los horarios de atención?',
    conversationId: 'conv-123',
    streaming: false
  })
});

const data = await response.json();
console.log(data.response);

Automatizaciones

Automatizá la creación y gestión de agentes:
import requests

# Crear un nuevo agente
response = requests.post(
    'https://app.horneross.com/api/agents',
    headers={'Authorization': 'Bearer tu_api_key'},
    json={
        'name': 'Agente de Ventas',
        'instructions': 'Sos un asistente de ventas amable...',
        'model': 'gpt-4o-mini'
    }
)

agent = response.json()
print(f"Agente creado: {agent['id']}")

Análisis y reporting

Extraé datos de conversaciones para análisis:
// Obtener conversaciones de un agente
const conversations = await fetch(
  'https://app.horneross.com/api/conversations?agentId=agent_123',
  {
    headers: {
      'Authorization': 'Bearer tu_api_key'
    }
  }
).then(res => res.json());

// Procesar para analytics
const stats = conversations.reduce((acc, conv) => {
  acc.totalMessages += conv.messageCount;
  if (conv.status === 'resolved') acc.resolved++;
  return acc;
}, { totalMessages: 0, resolved: 0 });

Límites y cuotas

Los límites de la API dependen de tu plan de suscripción:
PlanRequests/minutoRequests/día
Free101,000
Starter6010,000
Pro300100,000
EnterpriseCustomCustom
Si superás tu límite, recibirás un error 429 Too Many Requests. Esperá 60 segundos antes de reintentar.

Respuestas de error

Todos los errores siguen un formato estándar:
{
  "error": {
    "code": "invalid_request",
    "message": "El campo 'query' es requerido",
    "details": {
      "field": "query"
    }
  }
}

Códigos de error comunes

Código HTTPSignificado
400Bad Request - Parámetros inválidos
401Unauthorized - API key inválida o faltante
403Forbidden - Sin permisos para este recurso
404Not Found - Recurso no encontrado
429Too Many Requests - Límite de rate excedido
500Internal Server Error - Error del servidor

Versionado

La API actualmente está en versión v1. Los cambios breaking se comunicarán con al menos 3 meses de anticipación.

Cliente HTTP

Podés usar cualquier cliente HTTP para integrar con la API de Horneross:

JavaScript/TypeScript

fetch, axios, node-fetch

Python

requests, httpx, aiohttp

Otros lenguajes

Cualquier cliente HTTP REST

Próximos pasos

Soporte

¿Tenés problemas con la API?