OpenAPI 경로 항목은 GET·POST처럼 자주 쓰는 메서드를 고정 필드로 가집니다. 3.2의 additionalOperations는 그 밖의 HTTP 메서드를 이름으로 넣는 맵입니다. 명세는 COPY 같은 추가 연산의 요청·응답도 같은 Operation Object로 설명할 수 있습니다.
데모는 명세에 COPY /items/{id}를 추가하자 문서의 연산 목록에 새 카드가 생기는 모습을 보여줍니다. 설명 가능해졌다는 사실과 서버·프록시가 그 메서드를 실제로 지원한다는 사실은 별개이므로 배포 경로에서 검증해야 합니다.
언제 쓰나
표준 고정 필드에 없는 HTTP 메서드를 API 명세에 정확히 표현해야 할 때 씁니다.