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접근 가능한 차량 목록을 조회합니다. Query: limit, 커서 after.
POST/v1/vehicles내 차고에 차량을 생성합니다.
GET/v1/vehicles/:vehicleId차량 한 대를 조회합니다.
PATCH/v1/vehicles/:vehicleId차량 필드를 수정합니다.
DELETE/v1/vehicles/:vehicleId차량과 관련 기록을 삭제합니다(소유자).

차량 업데이트

HTTP리소스설명
GET/v1/vehicles/:vehicleId/updates상태 업데이트 목록을 조회합니다(주행거리, 연료/충전량, 상태, 타이어, 코멘트). Query: limit, afterId + afterAt.
POST/v1/vehicles/:vehicleId/updates차량의 새 업데이트를 기록합니다.

지출

HTTP리소스설명
GET/v1/expenses지출 목록을 최신순으로 조회합니다. Query: limit, vehicleId, 커서 afterId + afterValue.
POST/v1/expenses차량에 대한 지출 또는 차량 없는 개인 지출을 생성합니다.
PATCH/v1/expenses/:expenseId지출을 수정합니다.
DELETE/v1/expenses/:expenseId지출을 삭제합니다.

알림

HTTP리소스설명
GET/v1/reminders알림 목록을 기한순으로 조회합니다. Query: limit, vehicleId, 커서 afterId + afterValue.
POST/v1/reminders차량에 대한 알림 또는 개인 알림을 생성합니다.
PATCH/v1/reminders/:reminderId알림 필드를 수정합니다(지원되는 경우 완료 상태 포함).
DELETE/v1/reminders/:reminderId알림을 삭제합니다.

활동

HTTP리소스설명
GET/v1/activity플릿 소유자의 활동 기록입니다. Query: limit, 커서 afterId + afterAt.

플릿

HTTP리소스설명
GET/v1/fleet/members플릿 구성원, 역할, 차량 배정 목록을 조회합니다.
GET/v1/fleet/invites차량 팀 초대 목록을 가져옵니다. 반환 필드: inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired.