# 셀러

## 셀러 페널티 요약 조회

> 셀러의 페널티 현황을 요약하여 조회합니다.\
> \
> \## 응답 필드\
> \
> \- \`score\`: 현재 누적된 페널티 점수입니다.\
> \
> \- \`count\`: 페널티가 부과된 건수입니다.\
> \
> \- \`isPenalized\`: 현재 페널티가 적용 중인지 여부입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MerchantPenaltySummaryFepResponse":{"required":["count","isPenalized","score"],"type":"object","properties":{"score":{"type":"integer","description":"페널티 점수","format":"int32"},"count":{"type":"integer","description":"페널티 건수","format":"int32"},"isPenalized":{"type":"boolean","description":"페널티 적용 여부"}},"description":"셀러 페널티 요약 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/summary":{"get":{"tags":["셀러"],"summary":"셀러 페널티 요약 조회","description":"셀러의 페널티 현황을 요약하여 조회합니다.\n\n## 응답 필드\n\n- `score`: 현재 누적된 페널티 점수입니다.\n\n- `count`: 페널티가 부과된 건수입니다.\n\n- `isPenalized`: 현재 페널티가 적용 중인지 여부입니다.","operationId":"getMerchantPenaltySummary_1","parameters":[{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/MerchantPenaltySummaryFepResponse"}}}}}}}}}}}
```

## 셀러 페널티 부과 목록 조회

> 셀러에게 부과된 페널티 목록을 커서 기반으로 조회합니다.\
> \
> \## 페이징\
> \
> \- 커서 기반 페이징을 사용합니다.\
> \
> \- \`cursorId\`를 지정하지 않으면 최신 데이터부터 조회합니다.\
> \
> \- 응답의 \`nextCursorId\`를 다음 요청의 \`cursorId\`로 전달하면 다음 페이지를 조회할 수 있습니다.\
> \
> \- \`isLast\`가 \`true\`이면 더 이상 조회할 데이터가 없습니다.\
> \
> \- \`size\`는 최대 100까지 지정할 수 있습니다. (기본값: 20)\
> \
> \## 응답 필드\
> \
> \- \`content\`: 페널티 부과 상세 목록입니다.\
> \
> \- \`nextCursorId\`: 다음 페이지 조회를 위한 커서 ID입니다.\
> \
> \- \`isLast\`: 마지막 페이지 여부입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListPenaltyImpositionsFepResponse":{"required":["content","isLast"],"type":"object","properties":{"content":{"type":"array","description":"페널티 부과 목록","items":{"$ref":"#/components/schemas/PenaltyImpositionFepResponse"}},"nextCursorId":{"type":"integer","description":"다음 페이지 커서 ID","format":"int64"},"isLast":{"type":"boolean","description":"마지막 페이지 여부"}},"description":"셀러 페널티 부과 목록 응답"},"PenaltyImpositionFepResponse":{"required":["appeals","description","id","reason","regTs","score","status"],"type":"object","properties":{"id":{"type":"integer","description":"페널티 부과 ID","format":"int64"},"productItemId":{"type":"integer","description":"상품 아이템 ID","format":"int64"},"productItemName":{"type":"string","description":"상품 아이템명"},"productItemThumbnailUrl":{"type":"string","description":"상품 아이템 썸네일 URL"},"productId":{"type":"integer","description":"상품 ID","format":"int64"},"productName":{"type":"string","description":"상품명"},"orderProductId":{"type":"integer","description":"주문 상품 ID","format":"int64"},"reason":{"type":"string","description":"페널티 사유"},"description":{"type":"string","description":"페널티 상세 설명"},"score":{"type":"integer","description":"페널티 점수","format":"int32"},"status":{"type":"string","description":"페널티 상태 (PENALIZED: 적용 중, RELEASED: 해제, EXPIRED: 만료)"},"expiredTs":{"type":"string","description":"만료 일시","format":"date-time"},"releasedTs":{"type":"string","description":"해제 일시","format":"date-time"},"regTs":{"type":"string","description":"등록 일시","format":"date-time"},"appeals":{"type":"array","description":"소명 목록","items":{"$ref":"#/components/schemas/PenaltyAppealFepResponse"}}},"description":"페널티 부과 상세"},"PenaltyAppealFepResponse":{"required":["attachments","description","id","regTs","status"],"type":"object","properties":{"id":{"type":"integer","description":"소명 ID","format":"int64"},"description":{"type":"string","description":"소명 내용"},"status":{"type":"string","description":"소명 상태 (REQUESTED: 요청, REJECTED: 반려, APPROVED: 승인)"},"inspectedBy":{"type":"string","description":"검토자"},"inspectionTs":{"type":"string","description":"검토 일시","format":"date-time"},"rejectReason":{"type":"string","description":"반려 사유"},"regTs":{"type":"string","description":"등록 일시","format":"date-time"},"attachments":{"type":"array","description":"첨부파일 목록","items":{"$ref":"#/components/schemas/PenaltyAppealAttachmentFepResponse"}}},"description":"소명 상세"},"PenaltyAppealAttachmentFepResponse":{"required":["contentType","fileSize","id","originFileName"],"type":"object","properties":{"id":{"type":"integer","description":"첨부파일 ID","format":"int64"},"originFileName":{"type":"string","description":"원본 파일명"},"contentType":{"type":"string","description":"파일 타입"},"fileSize":{"type":"integer","description":"파일 크기 (bytes)","format":"int64"}},"description":"소명 첨부파일"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/impositions":{"get":{"tags":["셀러"],"summary":"셀러 페널티 부과 목록 조회","description":"셀러에게 부과된 페널티 목록을 커서 기반으로 조회합니다.\n\n## 페이징\n\n- 커서 기반 페이징을 사용합니다.\n\n- `cursorId`를 지정하지 않으면 최신 데이터부터 조회합니다.\n\n- 응답의 `nextCursorId`를 다음 요청의 `cursorId`로 전달하면 다음 페이지를 조회할 수 있습니다.\n\n- `isLast`가 `true`이면 더 이상 조회할 데이터가 없습니다.\n\n- `size`는 최대 100까지 지정할 수 있습니다. (기본값: 20)\n\n## 응답 필드\n\n- `content`: 페널티 부과 상세 목록입니다.\n\n- `nextCursorId`: 다음 페이지 조회를 위한 커서 ID입니다.\n\n- `isLast`: 마지막 페이지 여부입니다.","operationId":"getPenaltyImpositions","parameters":[{"name":"cursorId","in":"query","description":"커서 ID (지정하지 않으면 최신 데이터부터 조회)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"size","in":"query","description":"조회 건수","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListPenaltyImpositionsFepResponse"}}}}}}}}}}}
```

## 셀러 페널티 소명 자료 제출

> 페널티에 대한 소명 자료를 제출합니다.\
> \
> \## 요청 방식\
> \
> \- \`multipart/form-data\` 형식으로 요청합니다.\
> \
> \- \`penaltyImpositionId\`: 소명할 페널티 부과 ID입니다.\
> \
> \- \`description\`: 소명 내용입니다.\
> \
> \- \`attachments\`: 첨부파일 목록입니다. (선택)\
> \
> \## 첨부파일 제약 조건\
> \
> \- 최대 3개까지 첨부할 수 있습니다.\
> \
> \- 허용 확장자: \`png\`, \`jpg\`, \`jpeg\`, \`pdf\`, \`hwp\`\
> \
> \- 개별 파일 최대 크기: 10MB\
> \
> \- 요청 전체 최대 크기: 10MB\
> \
> \## 응답 필드\
> \
> \- \`appealId\`: 생성된 소명 ID입니다.\
> \
> \- \`status\`: 소명 상태입니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreatePenaltyAppealFepResponse":{"required":["appealId","status"],"type":"object","properties":{"appealId":{"type":"integer","description":"소명 ID","format":"int64"},"status":{"type":"string","description":"소명 상태 (REQUESTED: 요청, REJECTED: 반려, APPROVED: 승인)"}},"description":"페널티 소명 자료 제출 응답"}}},"paths":{"/api/v3/shopping-fep/merchants/penalty/appeals":{"post":{"tags":["셀러"],"summary":"셀러 페널티 소명 자료 제출","description":"페널티에 대한 소명 자료를 제출합니다.\n\n## 요청 방식\n\n- `multipart/form-data` 형식으로 요청합니다.\n\n- `penaltyImpositionId`: 소명할 페널티 부과 ID입니다.\n\n- `description`: 소명 내용입니다.\n\n- `attachments`: 첨부파일 목록입니다. (선택)\n\n## 첨부파일 제약 조건\n\n- 최대 3개까지 첨부할 수 있습니다.\n\n- 허용 확장자: `png`, `jpg`, `jpeg`, `pdf`, `hwp`\n\n- 개별 파일 최대 크기: 10MB\n\n- 요청 전체 최대 크기: 10MB\n\n## 응답 필드\n\n- `appealId`: 생성된 소명 ID입니다.\n\n- `status`: 소명 상태입니다.","operationId":"createPenaltyAppeal_1","parameters":[{"name":"penaltyImpositionId","in":"query","description":"페널티 부과 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"description","in":"query","description":"소명 내용","required":true,"schema":{"type":"string"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"attachments":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/CreatePenaltyAppealFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 목록 조회

> 셀러의 휴무일 목록을 기간별로 조회합니다.\
> \
> \## 조회 조건\
> \
> \- \`startDate\`와 \`endDate\`를 기준으로 해당 기간에 포함된 휴무일을 반환합니다.\
> \
> \- 날짜 형식은 \`yyyy-MM-dd\`입니다.\
> \
> \## 활용 예시\
> \
> \- 배송 예정일 계산 시 셀러 휴무일을 제외하여 정확한 배송일을 안내할 수 있습니다.\
> \
> \- 셀러 운영 캘린더에 휴무일을 표시할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ListMerchantHolidaysFepResponse":{"required":["items"],"type":"object","properties":{"items":{"type":"array","description":"휴무일 목록","items":{"$ref":"#/components/schemas/MerchantHoliday"}}},"description":"셀러 휴무일 목록 조회 응답"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays":{"get":{"tags":["셀러"],"summary":"셀러 휴무일 목록 조회","description":"셀러의 휴무일 목록을 기간별로 조회합니다.\n\n## 조회 조건\n\n- `startDate`와 `endDate`를 기준으로 해당 기간에 포함된 휴무일을 반환합니다.\n\n- 날짜 형식은 `yyyy-MM-dd`입니다.\n\n## 활용 예시\n\n- 배송 예정일 계산 시 셀러 휴무일을 제외하여 정확한 배송일을 안내할 수 있습니다.\n\n- 셀러 운영 캘린더에 휴무일을 표시할 수 있습니다.","operationId":"getMerchantHolidays","parameters":[{"name":"startDate","in":"query","description":"조회 시작일 (yyyy-MM-dd)","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"조회 종료일 (yyyy-MM-dd)","required":true,"schema":{"type":"string","format":"date"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListMerchantHolidaysFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 등록

> 셀러의 휴무일을 등록합니다. (upsert 방식)\
> \
> \## 등록 방식\
> \
> \- \`startDate\`부터 \`endDate\`까지의 기간에 해당하는 휴무일을 일괄 등록합니다.\
> \
> \- 동일한 날짜에 이미 휴무일이 등록되어 있는 경우 휴무명이 갱신됩니다. (upsert)\
> \
> \- 날짜 형식은 \`yyyy-MM-dd\`입니다.\
> \
> \## 활용 예시\
> \
> \- 설날, 추석 등 연휴 기간의 휴무일을 한 번에 등록할 수 있습니다.\
> \
> \- 특정 날짜의 임시 휴무를 등록할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreateMerchantHolidayFepRequest":{"required":["endDate","name","startDate"],"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string","description":"휴무명"},"startDate":{"type":"string","description":"시작일 (yyyy-MM-dd)","format":"date"},"endDate":{"type":"string","description":"종료일 (yyyy-MM-dd)","format":"date"}},"description":"셀러 휴무일 등록 요청"},"ListMerchantHolidaysFepResponse":{"required":["items"],"type":"object","properties":{"items":{"type":"array","description":"휴무일 목록","items":{"$ref":"#/components/schemas/MerchantHoliday"}}},"description":"셀러 휴무일 목록 조회 응답"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays":{"post":{"tags":["셀러"],"summary":"셀러 휴무일 등록","description":"셀러의 휴무일을 등록합니다. (upsert 방식)\n\n## 등록 방식\n\n- `startDate`부터 `endDate`까지의 기간에 해당하는 휴무일을 일괄 등록합니다.\n\n- 동일한 날짜에 이미 휴무일이 등록되어 있는 경우 휴무명이 갱신됩니다. (upsert)\n\n- 날짜 형식은 `yyyy-MM-dd`입니다.\n\n## 활용 예시\n\n- 설날, 추석 등 연휴 기간의 휴무일을 한 번에 등록할 수 있습니다.\n\n- 특정 날짜의 임시 휴무를 등록할 수 있습니다.","operationId":"registerMerchantHolidays","parameters":[{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantHolidayFepRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/ListMerchantHolidaysFepResponse"}}}}}}}}}}}
```

## 셀러 휴무일 수정

> 등록된 셀러 휴무일의 휴무명을 수정합니다.\
> \
> \## 수정 대상\
> \
> \- 휴무일 ID(\`holidayId\`)에 해당하는 휴무일의 휴무명을 변경합니다.\
> \
> \- 휴무명은 최대 100자까지 입력할 수 있습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UpdateMerchantHolidayFepRequest":{"required":["name"],"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string","description":"휴무명"}},"description":"셀러 휴무일 수정 요청"},"MerchantHoliday":{"required":["holiday","id","name"],"type":"object","properties":{"id":{"type":"integer","description":"휴무일 ID","format":"int64"},"name":{"type":"string","description":"휴무명"},"holiday":{"type":"string","description":"휴무일","format":"date"},"regTs":{"type":"string","description":"등록일시","format":"date-time"},"updTs":{"type":"string","description":"수정일시","format":"date-time"}},"description":"셀러 휴무일 항목"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays/{holidayId}":{"put":{"tags":["셀러"],"summary":"셀러 휴무일 수정","description":"등록된 셀러 휴무일의 휴무명을 수정합니다.\n\n## 수정 대상\n\n- 휴무일 ID(`holidayId`)에 해당하는 휴무일의 휴무명을 변경합니다.\n\n- 휴무명은 최대 100자까지 입력할 수 있습니다.","operationId":"updateMerchantHoliday","parameters":[{"name":"holidayId","in":"path","description":"휴무일 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMerchantHolidayFepRequest"}}},"required":true},"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/MerchantHoliday"}}}}}}}}}}}
```

## 셀러 휴무일 삭제

> 등록된 셀러 휴무일을 삭제합니다.\
> \
> \## 삭제 대상\
> \
> \- 휴무일 ID(\`holidayId\`)에 해당하는 휴무일을 삭제합니다.\
> \
> \- 삭제된 휴무일은 복구할 수 없습니다.

```json
{"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v3/shopping-fep/merchants/holidays/{holidayId}":{"delete":{"tags":["셀러"],"summary":"셀러 휴무일 삭제","description":"등록된 셀러 휴무일을 삭제합니다.\n\n## 삭제 대상\n\n- 휴무일 ID(`holidayId`)에 해당하는 휴무일을 삭제합니다.\n\n- 삭제된 휴무일은 복구할 수 없습니다.","operationId":"deleteMerchantHoliday","parameters":[{"name":"holidayId","in":"path","description":"휴무일 ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["REQUEST_FAILED","COMMON_ERROR"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"type":"object","description":"성공시 제공, 별도 내용이 없습니다. {}으로 반환"}}}}}}}}}}}
```