[m-a-king]

한눈에

토너먼트·위시 API 문서를 지금 서버 동작에 맞춤

• 이전: 클론 토너먼트를 없앤 뒤에도 API 문서가 옛 동작을 설명함
  • 예시: 사라진 에러 코드, 이제 나지 않는 권한 오류
• API 문서의 설명과 응답 예시를 서버가 실제로 내는 값으로 고침
• 서버 동작은 그대로
• 머지 뒤 바뀌는 것은 API 문서 화면뿐

Situation

이슈

• 클론 제거 뒤 낡은 토너먼트·위시 API 문서 정리 #1243
• 추가: dev 에 클론 정리 4-1단계(토너먼트 CLONE 잔재 정리 (4-1단계) #1191)가 먼저 들어와 있었음
  • 결과: 넘겨받은 점검 목록 36건 중 18건만 dev 에 남음
• 추가: 같은 종류의 어긋남 4건을 새로 찾음
  • 코드 미리보기의 주최자 완주 갈래 누락
  • 토너먼트 presign 예시 누락
  • 코드 입장 표의 미완주 409 행 누락
  • 목록 설명의 완료 기준
• 추가: 리뷰 중 고치지 않은 줄 2곳도 코드와 다름
  • 플레이 링크 인원 제한 없음 서술
  • 주최자가 나가 무효화된 링크를 404 로 안내

Task

이슈

• 클론 제거 뒤 낡은 토너먼트·위시 API 문서 정리 #1243
• 범위: 서비스 주석과 후보 수정·위시 새로고침 설명은 제외
  • 원인: 파싱 성공 단계(파싱 성공 시점의 버전 생성과 아이템 확정 (2단계) #1180) 브랜치가 같은 자리를 다시 씀. 여기서 고치면 합칠 때 충돌만 생김
• 범위: PLAY_LINK_ALREADY_CREATED(025) 는 유지
  • 원인: dev 에 결번 의도 주석과 함께 일부러 남겨 둔 결정

Action

동작 서술 정정

영역	이전	이후
한도 초과 429 code	WISH-010·TOURNAMENT-037	ITEM-006
후보 API 403(032·038)	복제 토너먼트	옛 클론 id 로 요청한 경우만
플레이 링크·코드 입장·목록의 완료 기준	토너먼트 COMPLETED	주최자 본인 플레이 완주
시작	PENDING 전환만 서술. 403 에 소유자 아님	주최자·멤버 두 경로. 403 은 비참여자만
삭제	소유자 목록에서만 제거	주최자 진행 상태별 세 갈래
코드 미리보기	PENDING 갈래만	완주 갈래와 404(026)·409(027) 추가
결승 기록	토너먼트가 COMPLETED	내 참여가 COMPLETED
플레이 링크 인원	제한 없음	초대·코드와 같은 정원
주최자가 나간 링크	404	409(027)

• 완료 기준은 토너먼트 상태가 아니라 주최자 참여 행으로 판정함
  • 원인: 주최자 완주 뒤에도 토너먼트 상태는 IN_PROGRESS 일 수 있음

선언·예시 보강

• 위시 수정 400 에 PRODUCTIMAGE-002 추가
• 위시·토너먼트 presign 에 content-type 미지정 예시 추가
• 초대 미리보기에 PENDING 아님 예시 추가
• 후보 수정의 400 중복 선언을 하나로 합침
  • 원인: 같은 응답 코드 선언이 둘이면 앞쪽 설명이 가려질 수 있음 (렌더 확인은 안 함)
• READY 후보 예시의 빈 이미지 채움
  • 원인: READY 는 이미지가 있어야 해 나올 수 없는 응답 모양
• presigned URL 만료 숫자 제거
  • 원인: 설정 기본값을 복제한 숫자라 설정이 바뀌면 조용히 낡음

Result

검증

• 리뷰어가 항목마다 dev 의 예외 발생 지점을 다시 추적해 판정함
  • 이미 해소된 항목은 손대지 않음

후속

• 파싱 성공 시점의 버전 생성과 아이템 확정 (2단계) #1180 브랜치가 통합 브랜치를 거쳐 이 PR 을 받을 때 같은 파일의 겹치는 자리 충돌 해소

---

연관 이슈

• close 클론 제거 뒤 낡은 토너먼트·위시 API 문서 정리 #1243

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

• Configuration used: Repository: TeamPiKi/core/.coderabbit.yml
• Review profile: CHILL
• Plan: Advanced
• Run ID: 22456e0a-f842-4420-9d39-28ba253aa06f

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Discord 스레드 연동용 메타데이터입니다. discord-pr-bot 워크플로가 자동 생성하며, 수정·삭제하면 PR 과 Discord 알림 연동이 끊깁니다.