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.