차량, 지출, 알림, 플릿 구성원, 활동에 프로그래밍 방식으로 접근할 수 있습니다. 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. |