Programmatischer Zugriff auf Fahrzeuge, Ausgaben, Erinnerungen, Flottenmitglieder und Aktivität. Base URL: https://api.aufix.app.
Überblick
- 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.
Authentifizierung
| HTTP | Ressource | Beschreibung |
|---|
| — | Authorization: Bearer … | Jede der folgenden Routen erfordert ein persönliches Zugriffstoken: Authorization: Bearer aufix_pat_…. Schlüssel erstellen und widerrufen Sie unter Einstellungen → Integrationen (das Secret wird nur einmal angezeigt). read — nur GET; write — alle Methoden. |
Fahrzeuge
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/vehicles | Zugängliche Fahrzeuge auflisten. Query: limit, Cursor after. |
| POST | /v1/vehicles | Ein Fahrzeug in Ihrer Garage anlegen. |
| GET | /v1/vehicles/:vehicleId | Ein einzelnes Fahrzeug abrufen. |
| PATCH | /v1/vehicles/:vehicleId | Fahrzeugfelder aktualisieren. |
| DELETE | /v1/vehicles/:vehicleId | Ein Fahrzeug und zugehörige Datensätze löschen (Eigentümer). |
Fahrzeug-Updates
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/vehicles/:vehicleId/updates | Statusupdates auflisten (Kilometerstand, Kraftstoff/Ladung, Zustand, Reifen, Kommentar). Query: limit, afterId + afterAt. |
| POST | /v1/vehicles/:vehicleId/updates | Ein neues Update für ein Fahrzeug erfassen. |
Ausgaben
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/expenses | Ausgaben auflisten (neueste zuerst). Query: limit, vehicleId, Cursor afterId + afterValue. |
| POST | /v1/expenses | Eine Ausgabe für ein Fahrzeug oder eine persönliche Ausgabe ohne Fahrzeug anlegen. |
| PATCH | /v1/expenses/:expenseId | Eine Ausgabe aktualisieren. |
| DELETE | /v1/expenses/:expenseId | Eine Ausgabe löschen. |
Erinnerungen
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/reminders | Erinnerungen nach Fälligkeit auflisten. Query: limit, vehicleId, Cursor afterId + afterValue. |
| POST | /v1/reminders | Eine Erinnerung für ein Fahrzeug oder eine persönliche Erinnerung anlegen. |
| PATCH | /v1/reminders/:reminderId | Felder einer Erinnerung aktualisieren (einschließlich Erledigt-Status, sofern unterstützt). |
| DELETE | /v1/reminders/:reminderId | Eine Erinnerung löschen. |
Aktivität
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/activity | Aktivitätsjournal des Flottenbesitzers. Query: limit, Cursor afterId + afterAt. |
Flotte
| HTTP | Ressource | Beschreibung |
|---|
| GET | /v1/fleet/members | Flottenmitglieder, Rollen und Fahrzeugzuweisungen auflisten. |
| GET | /v1/fleet/invites | Listet Fuhrpark-Einladungen auf. Gibt folgende Felder zurück: inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired. |