Accesso programmatico a veicoli, spese, promemoria, membri della flotta e attività. Base URL: https://api.aufix.app.
Panoramica
- 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.
Autenticazione
| HTTP | Risorsa | Descrizione |
|---|
| — | Authorization: Bearer … | Ogni route qui sotto richiede un token di accesso personale: Authorization: Bearer aufix_pat_…. Crea e revoca le chiavi in Impostazioni → Integrazioni (il segreto viene mostrato una sola volta). read — solo GET; write — tutti i metodi. |
Veicoli
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/vehicles | Elenca i veicoli accessibili. Query: limit, cursore after. |
| POST | /v1/vehicles | Crea un veicolo nel tuo garage. |
| GET | /v1/vehicles/:vehicleId | Ottieni un veicolo. |
| PATCH | /v1/vehicles/:vehicleId | Aggiorna i campi del veicolo. |
| DELETE | /v1/vehicles/:vehicleId | Elimina un veicolo e i record correlati (proprietario). |
Aggiornamenti del veicolo
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/vehicles/:vehicleId/updates | Elenca gli aggiornamenti di stato (chilometraggio, carburante/carica, condizioni, pneumatici, commento). Query: limit, afterId + afterAt. |
| POST | /v1/vehicles/:vehicleId/updates | Registra un nuovo aggiornamento per un veicolo. |
Spese
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/expenses | Elenca le spese (dalla più recente). Query: limit, vehicleId, cursore afterId + afterValue. |
| POST | /v1/expenses | Crea una spesa per un veicolo o una spesa personale senza veicolo. |
| PATCH | /v1/expenses/:expenseId | Aggiorna una spesa. |
| DELETE | /v1/expenses/:expenseId | Elimina una spesa. |
Promemoria
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/reminders | Elenca i promemoria per scadenza. Query: limit, vehicleId, cursore afterId + afterValue. |
| POST | /v1/reminders | Crea un promemoria per un veicolo o un promemoria personale. |
| PATCH | /v1/reminders/:reminderId | Aggiorna i campi di un promemoria (incluso lo stato di completamento, ove supportato). |
| DELETE | /v1/reminders/:reminderId | Elimina un promemoria. |
Attività
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/activity | Registro delle attività del proprietario della flotta. Query: limit, cursore afterId + afterAt. |
Flotta
| HTTP | Risorsa | Descrizione |
|---|
| GET | /v1/fleet/members | Elenca i membri della flotta, i ruoli e le assegnazioni dei veicoli. |
| GET | /v1/fleet/invites | Elenca gli inviti alla flotta. Restituisce inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired. |