API에 JSON 또는 YAML 확장 스키마를 추가하여 OpenAPI 스펙을 확장할 수 있습니다. 확장을 카탈로그 또는 카탈로그의 공간으로 가져온 후 API 스키마에 추가합니다.
시작하기 전에
이 작업을 수행하려면 카탈로그 편집 권한이 있어야 합니다.
이 태스크에 대한 정보
이 작업에서는 브라우저 기반 API Manager 사용자 인터페이스를 사용하여 OpenAPI 확장 기능을 카탈로그로 가져오는 방법을 설명합니다. 또는 개발자 툴킷 CLI를 사용할 수 있습니다. OpenAPI 확장에 대한 작업을 참조하십시오.
확장 스키마 파일의 예는 API 정의에서 확장 참조를 참조하십시오.
프로시저
- API Manager UI의 탐색 창에서 [관리]를
클릭한 다음, 작업할 카탈로그를 선택합니다. - 카탈로그에서 스페이스가 활성화된 경우, 다음 단계를 따라 작업할 스페이스를 선택하십시오:
- 공간 탭을 클릭하십시오.
- 작업할 영역을 선택하세요.
- 카탈로그에서 작업 중인 경우 카탈로그 설정 탭을 클릭하고, 공간에서 작업 중인 경우 공간 설정 탭을 클릭하십시오.
- 게이트웨이 서비스를 클릭하십시오.
- 사용하려는 게이트웨이 서비스 옆에서 옵션 아이콘을 클릭한 다음, ‘확장 프로그램
보기’를 클릭하세요. - 업로드 를 클릭한 후 파일을 끌어서 놓거나 찾아보고 선택하여 표시된 대로 확장 파일을 업로드하십시오. 확장 스키마 파일은 JSON 또는 YAML 파일입니다.
- 완료되면 업로드 를 클릭하십시오.
결과
사용자 정의 확장 기능이 이제 카탈로그 또는 스페이스로 가져와졌으며, API 디자이너 또는 API 관리자 사용자 인터페이스의 API 편집기를 사용하여 API를 개발할 때 이를 활용할 수 있습니다.
다음에 수행할 작업
필요에 따라 OpenAPI 확장을 API에 추가하십시오. API에 OpenAPI 확장 추가를 참조하십시오.