Programistyczny dostęp do pojazdów, wydatków, przypomnień, członków floty i aktywności. Base URL: https://api.aufix.app.
Przegląd
- 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.
Uwierzytelnianie
| HTTP | Zasób | Opis |
|---|
| — | Authorization: Bearer … | Każda poniższa trasa wymaga osobistego tokenu dostępu: Authorization: Bearer aufix_pat_…. Klucze tworzysz i unieważniasz w Ustawienia → Integracje (sekret wyświetlany jest tylko raz). read — tylko GET; write — wszystkie metody. |
Pojazdy
| HTTP | Zasób | Opis |
|---|
| GET | /v1/vehicles | Lista dostępnych pojazdów. Zapytanie: limit, kursor after. |
| POST | /v1/vehicles | Utwórz pojazd w swoim garażu. |
| GET | /v1/vehicles/:vehicleId | Pobierz jeden pojazd. |
| PATCH | /v1/vehicles/:vehicleId | Zaktualizuj pola pojazdu. |
| DELETE | /v1/vehicles/:vehicleId | Usuń pojazd wraz z powiązanymi rekordami (właściciel). |
Aktualizacje pojazdu
| HTTP | Zasób | Opis |
|---|
| GET | /v1/vehicles/:vehicleId/updates | Lista aktualizacji stanu (przebieg, paliwo/naładowanie, stan techniczny, opony, komentarz). Zapytanie: limit, afterId + afterAt. |
| POST | /v1/vehicles/:vehicleId/updates | Zapisz nową aktualizację pojazdu. |
Wydatki
| HTTP | Zasób | Opis |
|---|
| GET | /v1/expenses | Lista wydatków (od najnowszych). Zapytanie: limit, vehicleId, kursor afterId + afterValue. |
| POST | /v1/expenses | Utwórz wydatek dla pojazdu lub wydatek osobisty bez pojazdu. |
| PATCH | /v1/expenses/:expenseId | Zaktualizuj wydatek. |
| DELETE | /v1/expenses/:expenseId | Usuń wydatek. |
Przypomnienia
| HTTP | Zasób | Opis |
|---|
| GET | /v1/reminders | Lista przypomnień według terminu. Zapytanie: limit, vehicleId, kursor afterId + afterValue. |
| POST | /v1/reminders | Utwórz przypomnienie dla pojazdu lub przypomnienie osobiste. |
| PATCH | /v1/reminders/:reminderId | Zaktualizuj pola przypomnienia (w tym stan wykonania, jeśli jest obsługiwany). |
| DELETE | /v1/reminders/:reminderId | Usuń przypomnienie. |
Aktywność
| HTTP | Zasób | Opis |
|---|
| GET | /v1/activity | Dziennik aktywności właściciela floty. Zapytanie: limit, kursor afterId + afterAt. |
Flota
| HTTP | Zasób | Opis |
|---|
| GET | /v1/fleet/members | Lista członków floty, ról i przypisanych pojazdów. |
| GET | /v1/fleet/invites | Wyświetla zaproszenia do floty. Zwraca inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired. |