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