API Collection 관리

API Collection 은 관련 있는 여러 API 를 하나로 묶은 그룹입니다. 보통 하나의 서버(또는 하나의 OpenAPI 스펙)에 속한 API 들이 하나의 Collection 이 됩니다.

Collection 이 공유하는 것

• 이름·설명 — Collection 을 식별하는 정보
• 서버(servers) — base URL. 여러 서버를 두고 그중 하나를 선택할 수 있습니다.
• 태그(tags) — Collection 안의 API 들을 카테고리로 분류

각 API 는 전체 주소 대신 상대 경로 만 가집니다. 실제 요청 주소는 선택된 base URL + 경로 로 만들어지므로, 서버를 바꾸면(예: 개발용 ↔ 운영용) 모든 API 의 주소가 한 번에 바뀝니다.

Collection 만들기

• OpenAPI / Swagger 를 가져오면 스펙 하나가 하나의 Collection 으로 자동 생성됩니다.
• 직접 API 를 추가할 때는 기본 Collection("My APIs")에 들어갑니다.