Програмний доступ до автомобілів, витрат, нагадувань, учасників автопарку та журналу активності. 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. |