Acceso programático a vehículos, gastos, recordatorios, miembros de la flota y actividad. Base URL: https://api.aufix.app.
Descripción general
- 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 Ajustes → 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 | Lista los 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 asociados (propietario). |
Actualizaciones del vehículo
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/vehicles/:vehicleId/updates | Lista las actualizaciones de estado (kilometraje, combustible/carga, condición, neumáticos, 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 | Lista los gastos (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 | Lista los 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 se admita). |
| DELETE | /v1/reminders/:reminderId | Elimina un recordatorio. |
Actividad
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/activity | Registro de actividad del propietario de la flota. Query: limit, cursor afterId + afterAt. |
Flota
| HTTP | Recurso | Descripción |
|---|
| GET | /v1/fleet/members | Lista los miembros de la flota, 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. |