Acceso programático a vehículos, gastos, recordatorios, miembros de la flotilla y actividad. Base URL: https://api.aufix.app.
Resumen
- All REST routes are under
/v1/…. - Successful responses use
{ "data": … }. - Errors use
{ "error": { "code": "…", "message": "…" } }. - Operational routes require an active Fleet plan (Fleet, Fleet Pro, or Fleet Max).
- Personal access tokens (PAT) are rate-limited; responses may include
Retry-After.
Autenticación
| HTTP | Recurso | Descripción |
|---|
| — | Authorization: Bearer … | Todas las rutas siguientes requieren un token de acceso personal: Authorization: Bearer aufix_pat_…. Crea y revoca las claves en Configuración → Integraciones (el secreto se muestra una sola vez). read — solo GET; write — todos los métodos. |
Vehículos
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/vehicles | Muestra la lista de vehículos accesibles. Query: limit, cursor after. |
| POST | /v1/vehicles | Crea un vehículo en tu garaje. |
| GET | /v1/vehicles/:vehicleId | Obtiene un vehículo. |
| PATCH | /v1/vehicles/:vehicleId | Actualiza los campos de un vehículo. |
| DELETE | /v1/vehicles/:vehicleId | Elimina un vehículo y sus registros relacionados (propietario). |
Actualizaciones del vehículo
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/vehicles/:vehicleId/updates | Muestra la lista de actualizaciones de estado (kilometraje, combustible/carga, condición, llantas, comentario). Query: limit, afterId + afterAt. |
| POST | /v1/vehicles/:vehicleId/updates | Registra una nueva actualización de un vehículo. |
Gastos
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/expenses | Muestra la lista de gastos (los más recientes primero). Query: limit, vehicleId, cursor afterId + afterValue. |
| POST | /v1/expenses | Crea un gasto para un vehículo o un gasto personal sin vehículo. |
| PATCH | /v1/expenses/:expenseId | Actualiza un gasto. |
| DELETE | /v1/expenses/:expenseId | Elimina un gasto. |
Recordatorios
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/reminders | Muestra la lista de recordatorios por fecha de vencimiento. Query: limit, vehicleId, cursor afterId + afterValue. |
| POST | /v1/reminders | Crea un recordatorio para un vehículo o un recordatorio personal. |
| PATCH | /v1/reminders/:reminderId | Actualiza los campos de un recordatorio (incluido el estado de completado donde sea compatible). |
| DELETE | /v1/reminders/:reminderId | Elimina un recordatorio. |
Actividad
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/activity | Bitácora de actividad del propietario de la flotilla. Query: limit, cursor afterId + afterAt. |
Flotilla
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/fleet/members | Muestra la lista de miembros de la flotilla, sus roles y los vehículos asignados. |
| GET | /v1/fleet/invites | Lista las invitaciones de la flota. Devuelve inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired. |