Skip to content

Docs: 관리자 삭제 및 이미지 후보 선택 Swagger 명세 보완 #147

Closed

Description

@ppp1969

📌 Feature Issue

관리자 API Swagger 문서에서 도서 삭제 계약과 대표 후보 선택 API의 candidateId 의미를 프론트엔드가 오해하지 않도록 명세를 보완합니다.

도서 삭제 API는 성공 응답과 도서 미존재/처리 중 job 충돌 응답을 명시하고, 후보 선택 API는 candidateId가 슬롯 번호 1~4가 아니라 응답의 referenceCandidates[].id에 담긴 asset DB ID임을 명확히 설명합니다.

📝 To-do

  • 관리자 도서 삭제 API의 설명과 200/404/409 응답을 Swagger에 명시한다.
  • 후보 선택 API의 candidateId가 asset DB ID이며 slotNo가 아님을 명시한다.
  • 후보 응답 DTO의 id와 slotNo 설명을 선택 API 계약과 연결한다.
  • Swagger 명세 회귀 테스트를 추가한다.

ETC

실제 API 동작이나 요청 경로는 변경하지 않고 문서 명세만 보완합니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions