Autenticación y convenciones

La API pública de Liminar vive bajo el namespace api/v1/* y está pensada para integraciones externas (ERPs de terceros, automatizaciones, scripts internos de clientes).

Autenticación

Todas las rutas requieren un API key enviado como Bearer token:

Authorization: Bearer lim_live_xxxxxxxxxxxxxxxxxxxx

Cada key tiene scopes explícitos (por ejemplo products:read, orders:write) que determinan a qué recursos puede acceder. Las keys se generan y administran desde Configuración → API, en la sección "API keys" del panel de la cuenta.

Paginación

Los listados usan paginación 1-based vía query params:

La respuesta incluye un bloque meta con page, pageSize, total y totalPages.

Rate limiting

Cada respuesta incluye headers de rate limit:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Al superar el límite, la API responde 429 con el header Retry-After (segundos hasta el próximo intento permitido). Los endpoints deprecados incluyen un header Sunset (RFC 8594); actualmente ningún endpoint está deprecado.

Formato de errores

{
	"error": {
		"code": "insufficient_scope",
		"message": "La API key no tiene el scope orders:write"
	}
}

Estado de la API

Los 16 endpoints de api/v1/* (11 de lectura + 5 de escritura) están implementados y documentados en esta sección: productos, órdenes, clientes, entregas y facturas/remitos, incluyendo creación de facturas (POST /api/v1/invoices, con idempotencia obligatoria vía idempotencyKey) y de entregas (POST /api/v1/deliveries). No hay endpoints pendientes de una iteración anterior.