API v1.0.0145 operaciones documentadasActualizado 2026-08-09

API REST de Eskadia

Integra CRM, operaciones, finanzas, RR. HH., agentes IA, edición audiovisual, compras, obras y webhooks con tus aplicaciones.

Descargar OpenAPI 3.1 Contexto para IA
URL base: https://app.eskadia.com/api/v1

Autenticación y límites

Token Bearer

Todas las rutas excepto GET /health requieren un token creado en Ajustes → API.

Authorization: Bearer esk_live_...
Límites de uso
Lecturas GET500/min
Operaciones generales100/min
Escrituras20/min
Los POST admiten Idempotency-Key para evitar duplicados durante 24 horas. Los roles disponibles son viewer, member, manager y admin.

Catálogo actual de endpoints

El catálogo se contrasta con las rutas de la versión actual del CRM y excluye módulos sin API pública.

Plataforma

Salud del servicio, usuarios, organizaciones, configuración y actividad.

GET/healthEstado y versión del servicioPúblico
GET/dashboardKPIs agregadosmanager+
GET/reportsReportes de ventas, leads, actividad y proyectosmanager+
GET/settingsConfiguración de la organizaciónviewer+
PATCH/settingsActualizar configuraciónadmin+
GET/settings/deal-stagesEtapas del pipelineviewer+
GET/settings/webhooksConfiguración de webhooksadmin+
PATCH/settings/webhooksActualizar webhooksadmin+
POST/emails/sendEnviar emailmember+
POST/marketing/sendCrear y enviar campañamember+
POST/production/notifyNotificación de producciónmember+

CRM y ventas

Contactos, empresas, leads, oportunidades, catálogo y promociones.

GET/contactsListar contactosviewer+
POST/contactsCrear contactomember+
GET/contacts/{id}Detalle de contactoviewer+
PATCH/contacts/{id}Actualizar contactomember+
DELETE/contacts/{id}Eliminar contactoadmin+
GET/companiesListar empresasviewer+
POST/companiesCrear empresamember+
GET/companies/{id}Detalle de empresaviewer+
PATCH/companies/{id}Actualizar empresamember+
DELETE/companies/{id}Eliminar empresaadmin+
GET/leadsListar leadsviewer+
POST/leadsCrear leadmember+
GET/leads/{id}Detalle de leadviewer+
PATCH/leads/{id}Actualizar o archivar leadmember+
DELETE/leads/{id}Eliminar leadadmin+
GET/dealsListar oportunidadesviewer+
POST/dealsCrear oportunidadmember+
GET/deals/{id}Detalle de oportunidadviewer+
PATCH/deals/{id}Actualizar oportunidadmember+
DELETE/deals/{id}Eliminar oportunidadadmin+
GET/productsListar productosviewer+
GET/products/{id}Detalle de productoviewer+
GET/quotesListar cotizacionesviewer+
GET/quotes/{id}Detalle de cotizaciónviewer+
GET/promotionsListar promocionesviewer+
POST/promotionsCrear promociónmember+
GET/promotions/{id}Detalle de promociónviewer+
PATCH/promotions/{id}Actualizar promociónmember+
DELETE/promotions/{id}Eliminar promociónadmin+
POST/promotions/validate-codeValidar código promocionalviewer+

Trabajo y soporte

Tareas, proyectos, actividad y tickets de soporte.

GET/tasksListar tareasviewer+
POST/tasksCrear tareamember+
GET/tasks/{id}Detalle de tareaviewer+
PATCH/tasks/{id}Actualizar tareamember+
DELETE/tasks/{id}Eliminar tareaadmin+
GET/projectsListar proyectosviewer+
POST/projectsCrear proyectomember+
GET/projects/{id}Detalle de proyectoviewer+
PATCH/projects/{id}Actualizar proyectomember+
DELETE/projects/{id}Eliminar proyectoadmin+
GET/activitiesListar actividadviewer+
GET/activities/{id}Detalle de actividadviewer+
GET/support/ticketsListar ticketsviewer+
POST/support/ticketsCrear ticketmember+
GET/support/tickets/{id}Detalle de ticketviewer+
PATCH/support/tickets/{id}Actualizar ticketmember+
DELETE/support/tickets/{id}Eliminar ticketadmin+
GET/support/tickets/{id}/messagesListar mensajes del ticketviewer+
POST/support/tickets/{id}/messagesAñadir mensajemember+

Agentes IA

Agentes, ejecuciones y capacidades de inteligencia artificial.

POST/ai/{feature}Ejecutar una función de IAmember+
GET/agentsListar agentesviewer+
GET/agents/{type}Configuración de un agenteviewer+
POST/agents/{type}Ejecutar agentemanager+
PATCH/agents/{type}Actualizar agentemanager+
GET/agents/suggestionsListar sugerenciasviewer+
PATCH/agents/suggestions/{id}Resolver sugerenciamanager+
GET/agents/logConsultar registro de agentesviewer+

Edición audiovisual

Cola de vídeo, asignaciones, revisión y procesamiento.

GET/edicion/videosListar tarjetas de ediciónviewer+
GET/edicion/videos/{id}Detalle de tarjetaviewer+
PATCH/edicion/videos/{id}Actualizar tarjetamember+
POST/edicion/videos/batchActualizar hasta 50 tarjetasmember+
POST/edicion/videos/claimReservar o liberar tarjetasmember+

Finanzas

Facturas, gastos, tesorería, presupuestos y analítica.

GET/finance/invoicesListar facturasviewer+
POST/finance/invoicesCrear facturamember+
GET/finance/invoices/{id}Detalle de facturaviewer+
PATCH/finance/invoices/{id}Actualizar facturamember+
DELETE/finance/invoices/{id}Eliminar facturaadmin+
GET/finance/expensesListar gastosviewer+
POST/finance/expensesCrear gastomember+
GET/finance/expenses/{id}Detalle de gastoviewer+
PATCH/finance/expenses/{id}Actualizar gastomember+
DELETE/finance/expenses/{id}Eliminar gastomember+
GET/finance/cashflowConsultar tesoreríaviewer+
POST/finance/cashflowCrear movimientomember+
PATCH/finance/cashflowActualizar movimientomember+
DELETE/finance/cashflowEliminar movimientomember+
GET/finance/budgetsListar presupuestosviewer+
POST/finance/budgetsCrear presupuestomember+
PATCH/finance/budgetsActualizar presupuestomember+
DELETE/finance/budgetsEliminar presupuestomember+

Recursos humanos

Empleados, departamentos, ausencias, asistencia y nóminas.

GET/hr/employeesListar empleadosviewer+
POST/hr/employeesCrear empleadomember+
GET/hr/employees/{id}Detalle de empleadoviewer+
PATCH/hr/employees/{id}Actualizar empleadomember+
DELETE/hr/employees/{id}Eliminar empleadoadmin+
GET/hr/departmentsListar departamentosviewer+
POST/hr/departmentsCrear departamentomember+
GET/hr/absencesListar ausenciasviewer+
POST/hr/absencesSolicitar ausenciamember+
GET/hr/absences/{id}Detalle de ausenciaviewer+
PATCH/hr/absences/{id}Actualizar ausenciamember+
DELETE/hr/absences/{id}Eliminar ausenciaadmin+
GET/hr/attendanceConsultar asistenciaviewer+
POST/hr/attendanceRegistrar asistenciamember+
GET/hr/payrollConsultar nóminasmanager+
GET/hr/payroll/{employeeId}Nómina de empleadomanager+

Compras y obras

Proveedores, pedidos, RFQ, recepciones, contratos y órdenes de trabajo.

GET/purchases/suppliersListar proveedoresviewer+
GET/purchases/ordersListar pedidosviewer+
POST/purchases/ordersCrear pedidomember+
GET/purchases/rfqListar solicitudes de ofertaviewer+
POST/purchases/rfqCrear solicitud de ofertamember+
GET/purchases/receiptsListar recepcionesviewer+
POST/purchases/receiptsRegistrar recepciónmember+
GET/obras/lpu-itemsListar partidas LPUviewer+
POST/obras/lpu-itemsCrear partida LPUmanager+
PATCH/obras/lpu-itemsActualizar partida LPUmanager+
DELETE/obras/lpu-itemsEliminar partida LPUmanager+
GET/obras/client-contractsContratos de clienteviewer+
POST/obras/client-contractsCrear contrato de clientemember+
PATCH/obras/client-contractsActualizar contrato de clientemember+
DELETE/obras/client-contractsEliminar contrato de clienteadmin+
GET/obras/subcontractor-contractsContratos de subcontrataciónviewer+
POST/obras/subcontractor-contractsCrear contrato de subcontrataciónmember+
PATCH/obras/subcontractor-contractsActualizar contrato de subcontrataciónmember+
DELETE/obras/subcontractor-contractsEliminar contrato de subcontrataciónadmin+
GET/obras/work-ordersÓrdenes de trabajoviewer+
POST/obras/work-ordersCrear orden de trabajomember+
PATCH/obras/work-ordersActualizar orden de trabajomember+
DELETE/obras/work-ordersEliminar orden de trabajoadmin+

Integraciones y webhooks

Conexiones, sincronización, pruebas y eventos salientes.

GET/integrationsCatálogo de integracionesviewer+
GET/integrations/logsRegistro global de sincronizaciónviewer+
GET/integrations/{slug}Detalle de integraciónviewer+
PATCH/integrations/{slug}Actualizar configuraciónadmin+
POST/integrations/{slug}/connectConectar integraciónadmin+
POST/integrations/{slug}/disconnectDesconectar integraciónadmin+
POST/integrations/{slug}/syncEjecutar sincronizaciónmember+
POST/integrations/{slug}/testProbar conexiónadmin+
GET/integrations/{slug}/logsRegistro de una integraciónviewer+
GET/webhooksListar webhooksviewer+
POST/webhooksCrear webhookadmin+
PUT/webhooks/{id}Actualizar webhookadmin+
DELETE/webhooks/{id}Eliminar webhookadmin+
POST/webhooks/{id}/testProbar webhookadmin+
GET/webhooks/{id}/logsRegistro de entregasviewer+

Ejemplos

# Estado del servicio (sin autenticación)
curl https://app.eskadia.com/api/v1/health
# Listar contactos
curl -H "Authorization: Bearer esk_live_..." \
  "https://app.eskadia.com/api/v1/contacts?page=1&per_page=20&search=ana"
# Crear contacto sin riesgo de duplicados
curl -X POST \
  -H "Authorization: Bearer esk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-import-ana-001" \
  -d '{"first_name":"Ana","email":"ana@example.com"}' \
  https://app.eskadia.com/api/v1/contacts

¿Necesitas una integración?

Revisamos tu caso, permisos y flujo de datos antes de conectar sistemas.

Hablar con EskadiaVer guía funcional