Aufix API

Програмний доступ до автомобілів, витрат, нагадувань, учасників автопарку та журналу активності. Base URL: https://api.aufix.app.

Огляд

  • 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.

Автентифікація

HTTPРесурсОпис
—Authorization: Bearer …Кожен маршрут нижче потребує персонального токена доступу: Authorization: Bearer aufix_pat_…. Ключі створюються та відкликаються в Налаштування → Інтеграції (секрет показується лише один раз). read — лише GET; write — усі методи.

Автомобілі

HTTPРесурсОпис
GET/v1/vehiclesСписок доступних автомобілів. Запит: limit, курсор after.
POST/v1/vehiclesСтворити автомобіль у вашому гаражі.
GET/v1/vehicles/:vehicleIdОтримати один автомобіль.
PATCH/v1/vehicles/:vehicleIdОновити поля автомобіля.
DELETE/v1/vehicles/:vehicleIdВидалити автомобіль і пов’язані записи (власник).

Оновлення автомобіля

HTTPРесурсОпис
GET/v1/vehicles/:vehicleId/updatesСписок оновлень стану (пробіг, пальне/заряд, стан, шини, коментар). Запит: limit, afterId + afterAt.
POST/v1/vehicles/:vehicleId/updatesЗаписати нове оновлення для автомобіля.

Витрати

HTTPРесурсОпис
GET/v1/expensesСписок витрат (спочатку нові). Запит: limit, vehicleId, курсор afterId + afterValue.
POST/v1/expensesСтворити витрату для автомобіля або особисту витрату без автомобіля.
PATCH/v1/expenses/:expenseIdОновити витрату.
DELETE/v1/expenses/:expenseIdВидалити витрату.

Нагадування

HTTPРесурсОпис
GET/v1/remindersСписок нагадувань за терміном. Запит: limit, vehicleId, курсор afterId + afterValue.
POST/v1/remindersСтворити нагадування для автомобіля або особисте нагадування.
PATCH/v1/reminders/:reminderIdОновити поля нагадування (зокрема стан виконання, де підтримується).
DELETE/v1/reminders/:reminderIdВидалити нагадування.

Активність

HTTPРесурсОпис
GET/v1/activityЖурнал активності власника автопарку. Запит: limit, курсор afterId + afterAt.

Автопарк

HTTPРесурсОпис
GET/v1/fleet/membersСписок учасників автопарку, їхніх ролей і закріплених автомобілів.
GET/v1/fleet/invitesПовертає список запрошень до автопарку та поля inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired.