# 카플랫 개발자 센터 API 레퍼런스

## Rest API

Carplat에서 제공되는 일부 기능을 API 형태로 제공하여 개발사의 운영업무의 부담을 덜 수 있습니다.

클라이언트가 호출하는 일반적인 REST API입니다.

### 배차 취소

`PUT /developer/v1/reservation/{id}/dispatch/cancel`

• 배차를 취소합니다.

• 예약 상태가 **배차출발** 또는 **배차완료** 상태에서만 변경 가능합니다.

• 이미 등록된 배차 직원, 주차 메모, 배차 사진 등의  정보가 초기화되며 취소 후 예약완료 상태로 변경됩니다.

• 해당 예약 건에 발급 된 공유 스마트키(배차)는 사용 중지됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "해당 예약을 찾을 수 없습니다."
}
```

#### 응답 409

변경 불가능한 상태

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "변경 불가능한 상태입니다."
}
```

#### 응답 503

시스템 오류

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E060",
  "message": "요청 실패. 증상이 반복될 시 관리자에게 문의하세요."
}
```

### 배차완료 전 차량 사진 일괄 등록

`POST /developer/v1/reservation/{id}/dispatch/carImage`

• **배차출발** 상태에서만 등록 가능합니다.        
• 1장당 10mb 이하의 파일만 업로드 가능합니다.  
• 최대 20장까지 등록 가능합니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 조회할 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `carImages` | array<object> | Y | 등록할 차량 이미지 리스트<br>제약: 개수 1–20 |
| `carImages[].imageSubType` | string (enum) | Y | • 이미지 유형<br>- F : 전면<br>- R : 운전석 옆면<br>- B : 후면<br>- L : 조수석 옆면<br>- E : 기타(추가 사진)<br>• 업로드 규칙<br>- F, R, B, L 유형은 각각 **1장만 등록 가능합니다.**<br>- E 유형은 **16장까지 등록 가능합니다.**<br>가능한 값: `F`, `R`, `B`, `L`, `E`<br>예: `F` |
| `carImages[].attachFile` | object | Y | 첨부할 이미지 파일 정보입니다.<br>파일 자체의 데이터(base64 인코딩된 바이트)와 파일명을 포함한 객체입니다. |
| `carImages[].attachFile.fileByte` | string | Y | 첨부 이미지 파일을 Base64 형식으로 인코딩한 문자열입니다.<br>• 일반적으로 "data:image/png;base64,..." 형식으로 전달됩니다.<br>• 실제 파일의 바이너리 데이터를 문자열로 변환한 값<br>제약: 형식 byte<br>예: `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==` |
| `carImages[].attachFile.logicalFileName` | string | Y | 사용자가 업로드한 파일의 **원래 파일 이름**(논리명)입니다.<br>• 확장자 포함한 이름을 그대로 전달합니다. (예: parking.png, car.jpg)<br>• 허용되는 파일 확장자 목록입니다. (jpeg, jpg, png, pdf, webp)<br>예: `front.png` |

#### 요청 예시

```json
{
  "carImages": [
    {
      "imageSubType": "F",
      "attachFile": {
        "fileByte": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
        "logicalFileName": "front.png"
      }
    }
  ]
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "C004",
  "message": "허용되지 않은 확장자입니다."
}
```

```json
{
  "code": "C004",
  "message": "올바르지 않은 이미지 형식입니다. Base64로 인코딩된 이미지 데이터를 전송해주세요."
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "예약 정보를 찾을 수 없습니다."
}
```

#### 응답 409

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "예약 상태가 변경되었습니다."
}
```

```json
{
  "code": "E012",
  "message": "파일 크기가 10mb 를 초과할 수 없습니다."
}
```

```json
{
  "code": "E012",
  "message": "정면, 운전석 옆면, 후면, 조수석 옆면 사진을 모두 등록해 주세요."
}
```

```json
{
  "code": "E012",
  "message": "요청한 이미지 유형의 허용 업로드 개수를 초과하여 등록할 수 없습니다."
}
```

### 배차 완료

`PUT /developer/v1/reservation/{id}/dispatch/complete`

• 해당 예약을 배차완료 상태로 변경합니다.

• 예약 상태가 **배차출발** 상태에서만 변경 가능합니다.

• 배차완료 전 차량 사진과 주차 사진을 필수로 등록해야 합니다.

• 차량의 주차 위치 정보(parkingMemo)를 필수로 등록해야 합니다.

• 해당 예약 건에 발급 된 공유 스마트키(배차)는 사용 중지됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `parkingMemo` | string | Y | 주차 위치 메모<br>제약: 길이 1–50<br>예: `건물 지하 주차장 A구역` |

#### 요청 예시

```json
{
  "parkingMemo": "건물 지하 주차장 A구역"
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Bad Request

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E001",
  "message": "parkingMemo: 주차 메모를 입력해 주세요., parkingMemo: 최소 1자에서 최대 50자까지 입력 가능합니다."
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "예약을 찾을 수 없습니다."
}
```

```json
{
  "code": "E003",
  "message": "주차 사진을 등록해주세요."
}
```

#### 응답 409

변경 불가능한 상태

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "배차 사진을 등록해주세요."
}
```

```json
{
  "code": "E012",
  "message": "변경 불가능한 상태입니다."
}
```

#### 응답 503

시스템 오류

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E060",
  "message": "요청 실패. 증상이 반복될 시 관리자에게 문의하세요."
}
```

### 배차완료 전 주차 사진 등록

`POST /developer/v1/reservation/{id}/dispatch/parkingImage`

• **배차출발** 상태에서만 등록 가능합니다.      
• 10mb 이하의 파일만 업로드 가능합니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 조회할 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `attachFile` | object | Y | 첨부할 이미지 파일 정보입니다.<br>파일 자체의 데이터(base64 인코딩된 바이트)와 파일명을 포함한 객체입니다. |
| `attachFile.fileByte` | string | Y | 첨부 이미지 파일을 Base64 형식으로 인코딩한 문자열입니다.<br>• 일반적으로 "data:image/png;base64,..." 형식으로 전달됩니다.<br>• 실제 파일의 바이너리 데이터를 문자열로 변환한 값<br>제약: 형식 byte<br>예: `data:image/png;base64,iVB` |
| `attachFile.logicalFileName` | string | Y | 사용자가 업로드한 파일의 **원래 파일 이름**(논리명)입니다.<br>• 확장자 포함한 이름을 그대로 전달합니다. (예: parking.png, car.jpg)<br>• 허용되는 파일 확장자 목록입니다. (jpeg, jpg, png, pdf, webp)<br>예: `parking.png` |

#### 요청 예시

```json
{
  "attachFile": {
    "fileByte": "data:image/png;base64,iVB",
    "logicalFileName": "parking.png"
  }
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "C004",
  "message": "허용되지 않은 확장자입니다."
}
```

```json
{
  "code": "C004",
  "message": "올바르지 않은 이미지 형식입니다. Base64로 인코딩된 이미지 데이터를 전송해주세요."
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "예약 정보를 찾을 수 없습니다."
}
```

#### 응답 409

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "예약 상태가 변경되었습니다."
}
```

```json
{
  "code": "E012",
  "message": "파일 크기가 10mb 를 초과할 수 없습니다."
}
```

```json
{
  "code": "E012",
  "message": "사진이 이미 등록되어 추가 등록 할 수 없습니다."
}
```

### 배차 출발

`PUT /developer/v1/reservation/{id}/dispatch/start`

• 해당 예약을 배차출발 상태로 변경합니다.

• 예약 상태가 **예약완료** 상태에서만 변경 가능합니다.

• 배차 담당 직원을 지정합니다.

• 카플랫 계정(account)은 필수 입력 값입니다.

• 존재하지 않는 직원 계정으로는 등록할 수 없습니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `account` | string | Y | 담당자 계정 (직원 계정)<br>제약: 길이 6–100<br>예: `specialist` |

#### 요청 예시

```json
{
  "account": "specialist"
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Bad Request

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E001",
  "message": "account: 직원 계정 정보는 필수입니다., account: 직원 계정은 최소 6자, 최대 100자여야 합니다."
}
```

#### 응답 404

정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "예약 정보를 찾을 수 없습니다."
}
```

```json
{
  "code": "E003",
  "message": "직원 정보를 찾을 수 없습니다."
}
```

#### 응답 409

변경 불가능한 상태

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "변경 불가능한 상태입니다."
}
```

#### 응답 503

시스템 오류

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E060",
  "message": "요청 실패. 증상이 반복될 시 관리자에게 문의하세요."
}
```

### 회수완료 전 차량 사진 일괄 등록

`POST /developer/v1/reservation/{id}/recall/carImage`

• **반납완료** 상태에서만 등록 가능합니다.  
• 1장당 10mb 이하의 파일만 업로드 가능합니다.  
• 최대 20장까지 등록 가능합니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 조회할 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `carImages` | array<object> | Y | 등록할 차량 이미지 리스트<br>제약: 개수 1–20 |
| `carImages[].imageSubType` | string (enum) | Y | • 이미지 유형<br>- E : 기타(추가 촬영 이미지)<br>• 업로드 규칙<br>- 회수(Recall) 차량 이미지 업로드는 **E 유형만 허용됩니다.**<br>(F, R, B, L 유형은 회수 이미지로 등록할 수 없습니다.)<br>가능한 값: `E`<br>예: `E` |
| `carImages[].attachFile` | object | Y | 첨부할 이미지 파일 정보입니다.<br>파일 자체의 데이터(base64 인코딩된 바이트)와 파일명을 포함한 객체입니다. |
| `carImages[].attachFile.fileByte` | string | Y | 첨부 이미지 파일을 Base64 형식으로 인코딩한 문자열입니다.<br>• 일반적으로 "data:image/png;base64,..." 형식으로 전달됩니다.<br>• 실제 파일의 바이너리 데이터를 문자열로 변환한 값<br>제약: 형식 byte<br>예: `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==` |
| `carImages[].attachFile.logicalFileName` | string | Y | 사용자가 업로드한 파일의 **원래 파일 이름**(논리명)입니다.<br>• 확장자 포함한 이름을 그대로 전달합니다. (예: parking.png, car.jpg)<br>• 허용되는 파일 확장자 목록입니다. (jpeg, jpg, png, pdf, webp)<br>예: `front.png` |

#### 요청 예시

```json
{
  "carImages": [
    {
      "imageSubType": "E",
      "attachFile": {
        "fileByte": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
        "logicalFileName": "front.png"
      }
    }
  ]
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "C004",
  "message": "허용되지 않은 확장자입니다."
}
```

```json
{
  "code": "C004",
  "message": "올바르지 않은 이미지 형식입니다. Base64로 인코딩된 이미지 데이터를 전송해주세요."
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "예약 정보를 찾을 수 없습니다."
}
```

#### 응답 409

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "예약 상태가 변경되었습니다."
}
```

```json
{
  "code": "E012",
  "message": "파일 크기가 10mb 를 초과할 수 없습니다."
}
```

```json
{
  "code": "E012",
  "message": "정면, 운전석 옆면, 후면, 조수석 옆면 사진을 모두 등록해 주세요."
}
```

```json
{
  "code": "E012",
  "message": "요청한 이미지 유형의 허용 업로드 개수를 초과하여 등록할 수 없습니다."
}
```

### 회수 완료

`PUT /developer/v1/reservation/{id}/recall/complete`

• 해당 예약을 **회수완료** 상태로 변경합니다.

• 예약 상태가 **반납완료** 상태에서만 변경 가능합니다.

• 차량 회수 담당 직원을 지정합니다.

• 카플랫 계정(account)은 필수 입력값입니다.

• 존재하지 않는 직원 계정으로는 등록할 수 없습니다.

• 해당 예약 건에 발급 된 공유 스마트키(회수)는 사용 중지됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `account` | string | Y | 담당자 계정 (직원 계정)<br>제약: 길이 6–100<br>예: `specialist` |

#### 요청 예시

```json
{
  "account": "specialist"
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 404

예약 정보를 찾을 수 없음

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "해당 예약을 찾을 수 없습니다."
}
```

#### 응답 409

변경 불가능한 상태

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E012",
  "message": "변경 불가능한 상태입니다."
}
```

#### 응답 503

시스템 오류

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E060",
  "message": "요청 실패. 증상이 반복될 시 관리자에게 문의하세요."
}
```

### 스케줄 등록

`POST /developer/v1/schedule`

• 새로운 스케줄을 등록합니다.  
• 스케줄 시작 일시는 현재 시점을 기준으로 최대 7일 전까지만 설정할 수 있습니다.  
• 시작 일시는 종료 일시보다 이후가 될 수 없습니다.  
• 스케줄 기간은 최소 30분 이상이어야 합니다.

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `carNumber` | string | Y | 차량 번호<br>예: `106호3074` |
| `startDateTimeStr` | string | Y | 스케줄 시작일시(yyyy-MM-dd HH:mm 형식)<br>예: `2025-09-11 09:00` |
| `endDateTimeStr` | string | Y | 스케줄 종료일시(yyyy-MM-dd HH:mm 형식)<br>예: `2025-09-12 17:00` |
| `reason` | string | Y | 사유<br>제약: 길이 ≤ 50<br>예: `사고차량 수리` |

#### 요청 예시

```json
{
  "carNumber": "106호3074",
  "startDateTimeStr": "2025-09-11 09:00",
  "endDateTimeStr": "2025-09-12 17:00",
  "reason": "사고차량 수리"
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |
| `result` | object | Y |  |
| `result.id` | integer | Y | 등록된 스케줄 ID (스케줄 수정/삭제 시 사용)<br>제약: 형식 int64<br>예: `1` |

```json
{
  "code": "S000",
  "message": "성공",
  "result": {
    "id": 1
  }
}
```

#### 응답 400

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E004",
  "message": "시작 일시는 종료 일시보다 늦을 수 없습니다."
}
```

```json
{
  "code": "E004",
  "message": "시작 일시는 일주일 전까지만 선택할 수 있습니다."
}
```

```json
{
  "code": "E004",
  "message": "스케줄 기간은 최소 30분 이상이어야 합니다."
}
```

#### 응답 404

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "대상 데이터가 존재하지 않습니다."
}
```

#### 응답 409

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E011",
  "message": "스케줄 기간이 중복 됩니다."
}
```

### 스케줄 수정

`PUT /developer/v1/schedule/{id}`

• 지정된 스케줄 ID에 해당하는 스케줄 정보를 수정합니다.  
• 스케줄 시작 일시는 현재 시점을 기준으로 최대 7일 전까지만 설정할 수 있습니다.  
• 시작 일시는 종료 일시보다 이후가 될 수 없습니다.  
• 스케줄 기간은 최소 30분 이상이어야 합니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 스케줄 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `startDateTimeStr` | string | Y | 스케줄 시작일시(yyyy-MM-dd HH:mm 형식)<br>예: `2025-09-11 09:00` |
| `endDateTimeStr` | string | Y | 스케줄 종료일시(yyyy-MM-dd HH:mm 형식)<br>예: `2025-09-12 17:00` |
| `reason` | string | Y | 사유<br>제약: 길이 ≤ 50<br>예: `사고차량 수리` |

#### 요청 예시

```json
{
  "startDateTimeStr": "2025-09-11 09:00",
  "endDateTimeStr": "2025-09-12 17:00",
  "reason": "사고차량 수리"
}
```

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 400

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E004",
  "message": "시작 일시는 종료 일시보다 늦을 수 없습니다."
}
```

```json
{
  "code": "E004",
  "message": "시작 일시는 일주일 전까지만 선택할 수 있습니다."
}
```

```json
{
  "code": "E004",
  "message": "스케줄 기간은 최소 30분 이상이어야 합니다."
}
```

#### 응답 404

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "대상 데이터가 존재하지 않습니다."
}
```

#### 응답 409

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E011",
  "message": "스케줄 기간이 중복 됩니다."
}
```

```json
{
  "code": "E012",
  "message": "종료 일시가 7일 이상 지난 경우 수정이 불가합니다."
}
```

### 스케줄 삭제

`DELETE /developer/v1/schedule/{id}`

• 지정된 스케줄 ID에 해당하는 스케줄을 삭제합니다.  
• 삭제 처리 후에는 해당 스케줄 정보와 연관된 데이터가 더 이상 조회되지 않습니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 스케줄 ID<br>제약: 형식 int64<br>예: `1` |

#### 응답 200

OK

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

#### 응답 404

Error

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "E003",
  "message": "대상 데이터가 존재하지 않습니다."
}
```

## Callback Events

⚠️ **이 섹션의 API들은 테스트할 수 없습니다.**

서버에서 예약 상태 변경등의 정보를 자동으로 클라이언트에서 전달하는 이벤트 입니다.

해당 이벤트의 URL은 Carplat 에서 연동 신청 시 등록한 콜백 URL과 연결되어 정보가 전송됩니다.

### 예약 정보 등록 이벤트

`POST /events/reservation`

**서버 → 클라이언트 Webhook 이벤트**   
• 예약이 생성되었을 때 발생합니다.  
• 클라이언트는 이 엔드포인트를 구현하여 Carplat으로부터 예약 정보를 수신해야 합니다.

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `id` | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `12345` |
| `serviceId` | integer | Y | 서비스 ID<br>제약: 형식 int64<br>예: `1` |
| `serviceName` | string | Y | 서비스명<br>예: `비대면 렌트` |
| `reservationStatus` | integer | Y | 예약 상태 코드(예약 등록시에는 예약완료("5") 고정, 예약 수정시에는 모든 스테이터스가 전달 가능)<br>- 5: 예약완료<br>- 10: 배차출발<br>- 15: 배차완료<br>- 20: 이용 중<br>- 30: 반납완료<br>- 35: 회수완료<br>- 40: 예약취소<br>- 45: 노쇼취소<br>- 50: 예약실패(시스템취소)<br>예: `5` |
| `carId` | integer | Y | 차량 ID<br>제약: 형식 int64<br>예: `100` |
| `carNumber` | string | Y | 차량 번호<br>예: `12가3456` |
| `companyId` | integer | Y | 업체 ID<br>제약: 형식 int64<br>예: `10` |
| `companyName` | string | Y | 업체명<br>예: `(주)피플카` |
| `reservationCreateDateTime` | string | Y | 예약 생성 일시(yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-15T10:30:00.000+09:00` |
| `reservationStartDateTime` | string | Y | 예약 시작 일시(yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-20T09:00:00.000+09:00` |
| `reservationEndDateTime` | string | Y | 예약 종료 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-22T18:00:00.000+09:00` |
| `driveStartDateTime` | string |  | 운행 시작 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-20T09:15:00.000+09:00` |
| `driveEndDateTime` | string |  | 운행 종료 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-22T17:45:00.000+09:00` |
| `pickUpAddress` | string | Y | 픽업 주소<br>예: `서울시 강남구 테헤란로 123` |
| `driverName` | string | Y | 운전자 이름<br>예: `홍길동` |
| `driverBirthDate` | string | Y | 운전자 생년월일 (YYYYMMDD)<br>예: `19900101` |
| `driverPhone` | string | Y | 운전자 전화번호("-" 없이 등록)<br>예: `01012345678` |
| `driverLicenseNumber` | string | Y | 운전자 면허번호<br>예: `12-34-567890-12` |
| `driverAddress` | string | Y | 운전자 주소<br>예: `서울시 강남구 역삼동 123-45` |
| `pickUpMemo` | string |  | 픽업 메모<br>예: `건물 지하 주차장` |
| `parkingMemo` | string |  | 주차 메모<br>예: `B2 주차장 A구역` |
| `parkingImagePath` | string |  | 주차 이미지 경로 URL<br>예: `https://carplat.co.kr/images/parking/12345.jpg` |
| `parkingFeeType` | integer |  | 주차장 유형(1: 유료, 0: 불명)<br>예: `0` |
| `coDriver` | object |  | **동승자 정보**<br>해당 예약에 동승자가 등록된 경우에만 전송됩니다. 동승자가 없으면 이 필드 자체가 응답에 포함되지 않습니다.<br>제약: nullable |
| `coDriver.phone` | string |  | 동승자 전화번호("-" 없이 등록)<br>예: `01099104510` |
| `coDriver.date_of_birth` | string |  | 동승자 생년월일 (YYYYMMDD)<br>예: `19931111` |
| `coDriver.name` | string |  | 동승자명<br>예: `박해뤼` |
| `coDriver.driver_license_number` | string |  | 동승자 면허번호<br>예: `11-17-174133-01` |

#### 요청 예시

```json
{
  "id": 12345,
  "serviceId": 1,
  "serviceName": "비대면 렌트",
  "reservationStatus": 5,
  "carId": 100,
  "carNumber": "12가3456",
  "companyId": 10,
  "companyName": "(주)피플카",
  "reservationCreateDateTime": "2024-01-15T10:30:00.000+09:00",
  "reservationStartDateTime": "2024-01-20T09:00:00.000+09:00",
  "reservationEndDateTime": "2024-01-22T18:00:00.000+09:00",
  "driveStartDateTime": "2024-01-20T09:15:00.000+09:00",
  "driveEndDateTime": "2024-01-22T17:45:00.000+09:00",
  "pickUpAddress": "서울시 강남구 테헤란로 123",
  "driverName": "홍길동",
  "driverBirthDate": "19900101",
  "driverPhone": "01012345678",
  "driverLicenseNumber": "12-34-567890-12",
  "driverAddress": "서울시 강남구 역삼동 123-45",
  "pickUpMemo": "건물 지하 주차장",
  "parkingMemo": "B2 주차장 A구역",
  "parkingImagePath": "https://carplat.co.kr/images/parking/12345.jpg",
  "parkingFeeType": 0,
  "coDriver": {
    "phone": "01099104510",
    "date_of_birth": "19931111",
    "name": "박해뤼",
    "driver_license_number": "11-17-174133-01"
  }
}
```

#### 응답 200

이벤트를 성공적으로 수신했음을 알립니다.


| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

### 예약 정보 업데이트 이벤트

`PUT /events/reservation/{id}`

**서버 → 클라이언트 Webhook 이벤트**   
• 예약 정보가 변경되었을 때 발생합니다.  
• 클라이언트는 이 엔드포인트를 구현하여 Carplat으로부터 예약 변경 정보를 수신해야 합니다.  
• 연동 신청 시 등록한 콜백 URL로 전송됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `id` | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `12345` |
| `serviceId` | integer | Y | 서비스 ID<br>제약: 형식 int64<br>예: `1` |
| `serviceName` | string | Y | 서비스명<br>예: `비대면 렌트` |
| `reservationStatus` | integer | Y | 예약 상태 코드(예약 등록시에는 예약완료("5") 고정, 예약 수정시에는 모든 스테이터스가 전달 가능)<br>- 5: 예약완료<br>- 10: 배차출발<br>- 15: 배차완료<br>- 20: 이용 중<br>- 30: 반납완료<br>- 35: 회수완료<br>- 40: 예약취소<br>- 45: 노쇼취소<br>- 50: 예약실패(시스템취소)<br>예: `5` |
| `carId` | integer | Y | 차량 ID<br>제약: 형식 int64<br>예: `100` |
| `carNumber` | string | Y | 차량 번호<br>예: `12가3456` |
| `companyId` | integer | Y | 업체 ID<br>제약: 형식 int64<br>예: `10` |
| `companyName` | string | Y | 업체명<br>예: `(주)피플카` |
| `reservationCreateDateTime` | string | Y | 예약 생성 일시(yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-15T10:30:00.000+09:00` |
| `reservationStartDateTime` | string | Y | 예약 시작 일시(yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-20T09:00:00.000+09:00` |
| `reservationEndDateTime` | string | Y | 예약 종료 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-22T18:00:00.000+09:00` |
| `driveStartDateTime` | string |  | 운행 시작 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-20T09:15:00.000+09:00` |
| `driveEndDateTime` | string |  | 운행 종료 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-22T17:45:00.000+09:00` |
| `pickUpAddress` | string | Y | 픽업 주소<br>예: `서울시 강남구 테헤란로 123` |
| `driverName` | string | Y | 운전자 이름<br>예: `홍길동` |
| `driverBirthDate` | string | Y | 운전자 생년월일 (YYYYMMDD)<br>예: `19900101` |
| `driverPhone` | string | Y | 운전자 전화번호("-" 없이 등록)<br>예: `01012345678` |
| `driverLicenseNumber` | string | Y | 운전자 면허번호<br>예: `12-34-567890-12` |
| `driverAddress` | string | Y | 운전자 주소<br>예: `서울시 강남구 역삼동 123-45` |
| `pickUpMemo` | string |  | 픽업 메모<br>예: `건물 지하 주차장` |
| `parkingMemo` | string |  | 주차 메모<br>예: `B2 주차장 A구역` |
| `parkingImagePath` | string |  | 주차 이미지 경로 URL<br>예: `https://carplat.co.kr/images/parking/12345.jpg` |
| `parkingFeeType` | integer |  | 주차장 유형(1: 유료, 0: 불명)<br>예: `0` |
| `coDriver` | object |  | **동승자 정보**<br>해당 예약에 동승자가 등록된 경우에만 전송됩니다. 동승자가 없으면 이 필드 자체가 응답에 포함되지 않습니다.<br>제약: nullable |
| `coDriver.phone` | string |  | 동승자 전화번호("-" 없이 등록)<br>예: `01099104510` |
| `coDriver.date_of_birth` | string |  | 동승자 생년월일 (YYYYMMDD)<br>예: `19931111` |
| `coDriver.name` | string |  | 동승자명<br>예: `박해뤼` |
| `coDriver.driver_license_number` | string |  | 동승자 면허번호<br>예: `11-17-174133-01` |

#### 요청 예시

```json
{
  "id": 12345,
  "serviceId": 1,
  "serviceName": "비대면 렌트",
  "reservationStatus": 5,
  "carId": 100,
  "carNumber": "12가3456",
  "companyId": 10,
  "companyName": "(주)피플카",
  "reservationCreateDateTime": "2024-01-15T10:30:00.000+09:00",
  "reservationStartDateTime": "2024-01-20T09:00:00.000+09:00",
  "reservationEndDateTime": "2024-01-22T18:00:00.000+09:00",
  "driveStartDateTime": "2024-01-20T09:15:00.000+09:00",
  "driveEndDateTime": "2024-01-22T17:45:00.000+09:00",
  "pickUpAddress": "서울시 강남구 테헤란로 123",
  "driverName": "홍길동",
  "driverBirthDate": "19900101",
  "driverPhone": "01012345678",
  "driverLicenseNumber": "12-34-567890-12",
  "driverAddress": "서울시 강남구 역삼동 123-45",
  "pickUpMemo": "건물 지하 주차장",
  "parkingMemo": "B2 주차장 A구역",
  "parkingImagePath": "https://carplat.co.kr/images/parking/12345.jpg",
  "parkingFeeType": 0,
  "coDriver": {
    "phone": "01099104510",
    "date_of_birth": "19931111",
    "name": "박해뤼",
    "driver_license_number": "11-17-174133-01"
  }
}
```

#### 응답 200

이벤트를 성공적으로 수신했음을 알립니다.


| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

### 예약 차량 변경 이벤트

`PUT /events/reservation/{id}/car-change`

**서버 → 클라이언트 Webhook 이벤트**   
• 예약의 차량 정보가 변경되었을 때 발생합니다.  
• 차량 변경시 "예약 정보 업데이트 이벤트" 와 해당 이벤트 "예약 차량 변경 이벤트" 가 연속으로 호출되도록 설계되어 있습니다.(신청시)   
• 차량 변경시 차량관리에 사용할 경우에만 사용신청을 부탁드립니다.   
• 클라이언트는 이 엔드포인트를 구현하여 Carplat으로부터 차량 변경 정보를 수신해야 합니다.     
• 연동 신청 시 등록한 콜백 URL로 전송됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 응답 200

이벤트를 성공적으로 수신했음을 알립니다.


| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `id` | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `12345` |
| `beforeCarId` | integer | Y | 변경 전 차량 ID<br>제약: 형식 int64<br>예: `100` |
| `beforeCarNumber` | string | Y | 변경 전 차량 번호<br>예: `12가3456` |
| `updateCarId` | integer | Y | 변경 후 차량 ID<br>제약: 형식 int64<br>예: `101` |
| `updateCarNumber` | string | Y | 변경 후 차량 번호<br>예: `34나5678` |

```json
{
  "id": 12345,
  "beforeCarId": 100,
  "beforeCarNumber": "12가3456",
  "updateCarId": 101,
  "updateCarNumber": "34나5678"
}
```

### 예약 반납 연장 이벤트

`PUT /events/reservation/{id}/extension`

**서버 → 클라이언트 Webhook 이벤트**   
• 예약의 반납(종료) 일시가 연장되었을 때 발생합니다.  
• 예약 반납 연장시 "예약 정보 업데이트 이벤트" 와 해당 이벤트 "예약 반납 연장 이벤트" 가 연속으로 호출되도록 설계되어 있습니다.(신청시)  
• 예약 반납 연장시 예약관리에 사용할 경우에만 사용신청을 부탁드립니다.  
• 클라이언트는 이 엔드포인트를 구현하여 Carplat으로부터 반납 연장 정보를 수신해야 합니다.  
• 연동 신청 시 등록한 콜백 URL로 전송됩니다.

#### 파라미터

| 이름 | 위치 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- | --- |
| `id` | path | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `1` |

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `id` | integer | Y | 예약 ID<br>제약: 형식 int64<br>예: `12345` |
| `beforeReservationEndDateTime` | string | Y | 연장 전 반납(종료) 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>예: `2025-09-12T17:00:00.000+09:00` |
| `afterReservationEndDateTime` | string | Y | 연장 후 반납(종료) 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>예: `2025-09-12T20:00:00.000+09:00` |

#### 요청 예시

```json
{
  "id": 12345,
  "beforeReservationEndDateTime": "2025-09-12T17:00:00.000+09:00",
  "afterReservationEndDateTime": "2025-09-12T20:00:00.000+09:00"
}
```

#### 응답 200

이벤트를 성공적으로 수신했음을 알립니다.


| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```

### 하이패스 결제 정보 전달

`POST /events/hipass`

**서버 → 클라이언트 Webhook 이벤트**  
• 차량의 하이패스 통행 내역이 발생했을 때 전송됩니다.  
• 클라이언트는 이 엔드포인트를 구현하여 Carplat으로부터 하이패스 통행 정보를 수신해야 합니다.  
• 연동 신청 시 등록한 콜백 URL로 전송됩니다.

#### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `carId` | integer | Y | 차량 ID<br>제약: 형식 int64<br>예: `100` |
| `carNumber` | string | Y | 차량 번호<br>예: `12가3456` |
| `amount` | integer | Y | 통행료 (원)<br>예: `3500` |
| `transactedDateTime` | string | Y | 통행 일시 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX 형식)<br>제약: 형식 date-time<br>예: `2024-01-20T10:30:00.000+09:00` |
| `comment` | string |  | 통행 정보 메모. 투루카 연동일 경우 사용. "서비스명(#예약번호)"<br>제약: nullable<br>예: `투루카 카셰어링(#12345)` |

#### 요청 예시

```json
{
  "carId": 100,
  "carNumber": "12가3456",
  "amount": 3500,
  "transactedDateTime": "2024-01-20T10:30:00.000+09:00",
  "comment": "투루카 카셰어링(#12345)"
}
```

#### 응답 200

이벤트를 성공적으로 수신했음을 알립니다.


| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `code` | string | Y | 결과 코드<br>예: `S000` |
| `message` | string | Y | 결과 메세지<br>예: `성공` |

```json
{
  "code": "S000",
  "message": "성공"
}
```