Documentación API

API REST completa con más de 175 endpoints para integrar Cotiza AI con cualquier sistema

Autenticación basada en JWT con soporte multi-tenant. Tokens de acceso y refresh para sesiones seguras.

Authorization: Bearer <token>

Cada tenant opera de forma aislada. Incluye el tenant ID en las peticiones para acceder a los datos correctos.

X-Tenant-ID: <tenant_id>

Todas las respuestas usan JSON. Paginación, filtrado y ordenamiento disponibles en endpoints de listado.

Content-Type: application/json

Endpoints principales

POST /api/v1/auth/login Iniciar sesión

POST /api/v1/auth/register Registrar usuario

POST /api/v1/auth/refresh Renovar token

CRUD completo de cotizaciones

GET /api/v1/tenants/{id}/quotations Listar cotizaciones

POST /api/v1/tenants/{id}/quotations Crear cotización

PUT /api/v1/tenants/{id}/quotations/{qid} Actualizar cotización

DELETE /api/v1/tenants/{id}/quotations/{qid} Eliminar cotización

Gestión de clientes y contactos

GET /api/v1/tenants/{id}/customers Listar clientes

POST /api/v1/tenants/{id}/customers Crear cliente

GET /api/v1/tenants/{id}/customers/{cid} Detalle de cliente

Catálogo de productos y servicios

GET /api/v1/tenants/{id}/catalog/products Listar productos

POST /api/v1/tenants/{id}/catalog/products Crear producto

PUT /api/v1/tenants/{id}/catalog/products/{pid} Actualizar producto

Métricas y reportes del negocio

GET /api/v1/tenants/{id}/admin/analytics/dashboard Dashboard general

GET /api/v1/tenants/{id}/admin/analytics/mrr Revenue recurrente

GET /api/v1/tenants/{id}/admin/analytics/churn-rate Tasa de abandono

La documentación completa de la API incluye ejemplos, schemas y SDKs.