API Aufix

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

HTTPRisorsaDescrizione
—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

HTTPRisorsaDescrizione
GET/v1/vehiclesElenca i veicoli accessibili. Query: limit, cursore after.
POST/v1/vehiclesCrea un veicolo nel tuo garage.
GET/v1/vehicles/:vehicleIdOttieni un veicolo.
PATCH/v1/vehicles/:vehicleIdAggiorna i campi del veicolo.
DELETE/v1/vehicles/:vehicleIdElimina un veicolo e i record correlati (proprietario).

Aggiornamenti del veicolo

HTTPRisorsaDescrizione
GET/v1/vehicles/:vehicleId/updatesElenca gli aggiornamenti di stato (chilometraggio, carburante/carica, condizioni, pneumatici, commento). Query: limit, afterId + afterAt.
POST/v1/vehicles/:vehicleId/updatesRegistra un nuovo aggiornamento per un veicolo.

Spese

HTTPRisorsaDescrizione
GET/v1/expensesElenca le spese (dalla più recente). Query: limit, vehicleId, cursore afterId + afterValue.
POST/v1/expensesCrea una spesa per un veicolo o una spesa personale senza veicolo.
PATCH/v1/expenses/:expenseIdAggiorna una spesa.
DELETE/v1/expenses/:expenseIdElimina una spesa.

Promemoria

HTTPRisorsaDescrizione
GET/v1/remindersElenca i promemoria per scadenza. Query: limit, vehicleId, cursore afterId + afterValue.
POST/v1/remindersCrea un promemoria per un veicolo o un promemoria personale.
PATCH/v1/reminders/:reminderIdAggiorna i campi di un promemoria (incluso lo stato di completamento, ove supportato).
DELETE/v1/reminders/:reminderIdElimina un promemoria.

Attività

HTTPRisorsaDescrizione
GET/v1/activityRegistro delle attività del proprietario della flotta. Query: limit, cursore afterId + afterAt.

Flotta

HTTPRisorsaDescrizione
GET/v1/fleet/membersElenca i membri della flotta, i ruoli e le assegnazioni dei veicoli.
GET/v1/fleet/invitesElenca gli inviti alla flotta. Restituisce inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired.