Endpoints

La FE API expone 6 endpoints públicos bajo la base URL https://digimart-api-v2.appworkcloud.com/api/v1/fe. Todos requieren autenticación vía Authorization: Bearer <JWT> excepto /login (que es donde obtienes el JWT).

POST /login POST /invoices GET /invoices/:id GET /invoices GET /usage GET /billing/current-period

Scope requerido por endpoint

Endpoint	Scope requerido
`POST /login`	— (no requiere)
`POST /invoices`	`invoices:write`
`GET /invoices/:id`	`invoices:read`
`GET /invoices`	`invoices:read`
`GET /usage`	`usage:read`
`GET /billing/current-period`	`billing:read`

Los scopes se asignan al crear cada API key. Una key con scope limitado sólo puede llamar los endpoints que match. Más detalles en Autenticación → Scopes.

Convenciones generales

Content-Type: siempre application/json para requests con body.
Encoding: UTF-8 obligatorio.
Fechas: ISO 8601 con timezone (ej. 2026-06-15T14:23:11Z).
Errores 4xx: vienen con { message, statusCode }.
Errores 5xx: se reintentan con backoff exponencial. Si persisten, contáctanos.

Ver también: Códigos de error, Ejemplos.

Autenticación POST /login