OpenAPI 3.2의 Tag Object에는 짧은 summary, 상위 태그를 가리키는 parent, 용도를 분류하는 kind가 있습니다. 예를 들어 kind가 nav인 태그를 문서 탐색에 쓰고, books 태그의 parent를 products로 두면 연산을 부모 아래에 묶어 보여줄 수 있습니다. 부모 태그는 명세에 존재해야 하며 순환 관계는 허용되지 않습니다.
데모는 평평한 태그 목록이 계층형 탐색으로 바뀌는 과정을 보여줍니다. 실제 문서 도구가 새 필드를 지원하는지 확인하고, 화면 탐색용 분류와 코드 생성용 분류를 혼동하지 않도록 kind를 정해야 합니다.
언제 쓰나
엔드포인트가 많은 API 문서에서 연산 탐색을 계층으로 정리할 때 사용합니다.