Apigee API 허브를 사용하면 조직에서 관심 있는 모든 API에 대한 정보를 통합하고 구성할 수 있습니다. API 허브를 사용하면 개발자가 API를 쉽게 탐색 및 평가하고 가능할 때마다 다른 팀의 작업을 활용할 수 있도록 API에 대한 중요 정보를 캡처할 수 있습니다. API 플랫폼 팀은 API 허브를 사용하여 API 포트폴리오를 파악하고 관리할 수 있습니다.
그림 1. API 허브를 사용하면 API를 가져오고 등록하고, API를 검색하고, 종속 항목을 추적하고, API 사양에 린트 작업을 수행하는 등의 작업을 할 수 있습니다.
중앙 집중식 API 관리의 가치
직접 개발하여 사용하는 API의 수가 증가하면서 많은 조직이 어려움을 겪고 있습니다. API 수가 증가하면 추적이 더욱 어려워지면서 결국 재사용이 아닌 중복으로 이어질 수 있어 비용이 많이 드는 비효율성을 초래할 수 있습니다.
설계 표준 및 거버넌스 확인 없이 API가 급증하면 API 환경의 비일관성이 증가하면서 팀의 업무 속도가 느려질 수 있으며, 이때 체계적인 API 프로그램을 통해 업무를 빠르게 진행할 수 있습니다.
API 허브 환경은 주로 조직의 네트워크 생태계 내부와 외부에서 API를 찾고, 나열하고, 비교하고, 평가해야 하는 조직 내 API 소비자와 생산자를 대상으로 합니다.
API 허브를 사용하면 API 버전, 종속 항목, 배포 등을 포함하여 연결된 항목과 함께 모든 API의 전체 카탈로그를 관리할 수 있습니다. 또한 API 사양을 API 버전과 연결할 수 있으며, OpenAPI 사양의 경우 API 허브가 이를 파싱하고 API 작업을 포함한 메타데이터를 추출합니다. 또한 API 버전을 특정 API 배포 엔드포인트에 연결할 수 있습니다.
Apigee API 허브의 주요 이점
API 허브 관리자는 다음을 수행할 수 있습니다.
모든 API의 전체 카탈로그와 연결된 항목을 추가, 수정, 관리합니다.
API 버전 관리, 버전을 API 사양에 연결, 사양에서 파싱된 작업 표시, API 버전을 특정 배포 엔드포인트에 연결 등을 지원하는 전체 API 수명 주기를 관리합니다.
API 세트에 속성을 추가하고 다양한 수명 주기 단계, 규정 준수 정보, 추적하려는 기타 정보로 태그합니다.
다양한 속성 집합을 기반으로 API를 필터링하고 검색합니다.
API 허브를 하나 이상의 Apigee 및 Apigee Hybrid 프로젝트에 연결하여 Apigee API 프록시 정보를 자동으로 가져오고 API 허브에 저장합니다. API 허브는 6시간마다 한 번씩 주기적으로 Apigee 프로젝트에 연결하는 스케줄러를 실행하고 최신 프록시 정의를 가져옵니다.
자유 형식 검색으로 강력한 시맨틱 검색 기능을 사용하여 API를 찾습니다.
린트 기능을 사용하여 API 사양 파일의 규정 준수를 추적합니다.
API에서 여러 작업 간 종속 항목을 모델링하여 API의 종속 항목을 추적합니다.
API 수명 주기 데이터를 저장합니다.
API 허브를 사용하면 API에 관한 풍부한 정보를 한곳에 모아 API 포트폴리오의 일관성, 사용, 재사용, 거버넌스를 가속화할 수 있습니다.
주요 기능 및 개념
API 리소스
API 리소스는 조직의 네트워크 생태계 내에 있는 API를 나타냅니다. API 허브에 저장된 API 리소스를 검색할 수 있으며 API에 대한 자세한 운영 및 설명 정보(예: 배포, 버전, 작업, 수명 주기 단계, 기타 주요 속성)를 제공합니다.
버전 관리
API 버전을 모델링하고 구성하는 기능은 API 허브의 핵심 기능입니다.
API 허브의 모든 API 리소스에는 연결된 버전이 하나 이상 있습니다. 버전을 특정 시점의 API 상태로 생각하면 됩니다. 기본적으로 버전은 기본 작업 집합, 배포, 기타 메타데이터를 기반으로 API를 그룹화하고 구성하는 데 도움이 됩니다.
Apigee API 프록시 자동 등록
자동 등록은 외부 시스템의 API 데이터를 API 허브로 가져오는 것을 의미합니다.
런타임 프로젝트를 API 허브에 연결하여 API 허브에서 직접 Apigee 또는 Apigee Hybrid 런타임 프로젝트에 있는 모든 프록시를 등록할 수 있습니다. Apigee 프록시 자동 등록을 참조하세요.
API 허브의 강력한 검색 기능은 API 정의의 일부를 기반으로 검색할 수 있는 LLM 기반 자유 텍스트 및 필터 기반 검색 작업을 모두 지원합니다. 이러한 강력한 검색 도구를 사용하면 특정 사용 사례에 적합한 API 애셋을 식별하여 API 엔지니어링 작업을 재빌드하거나 중복하지 않을 수 있습니다.
종속 항목 매핑
API 허브 종속 항목을 사용하면 API 간의 공급망 관계를 보고 관리할 수 있습니다. API의 종속 항목을 찾고 추적하면 API 생태계를 보다 효율적으로 관리하고 손상된 API 작업 문제를 해결할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-07(UTC)"],[[["\u003cp\u003eApigee API hub centralizes and organizes information about an organization's APIs, making them easier to discover, evaluate, and reuse, ultimately improving efficiency.\u003c/p\u003e\n"],["\u003cp\u003eAPI hub manages a complete catalog of APIs and their entities, including versions, dependencies, and deployments, supporting the entire API lifecycle.\u003c/p\u003e\n"],["\u003cp\u003eAdministrators can manage APIs, add attributes, filter and search based on various characteristics, and link to Apigee projects for automatic proxy information.\u003c/p\u003e\n"],["\u003cp\u003eKey features include versioning, auto-registration of Apigee API proxies, spec parsing and linting, robust search capabilities, and dependency mapping to enhance API management.\u003c/p\u003e\n"],["\u003cp\u003eAPI hub allows you to track API compliance and model dependencies, enhancing governance, and facilitating the efficient management of the API ecosystem.\u003c/p\u003e\n"]]],[],null,["*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\nApigee API hub lets you consolidate and organize information about all of the APIs of interest to\nyour organization. API hub lets you capture critical information about APIs that allows developers to discover\nand evaluate them easily and leverage the work of other teams wherever possible. API platform teams can use\nAPI hub to gain visibility into and manage their portfolio of APIs.\n**Figure 1.** API hub lets you import and register APIs, search APIs, track dependencies, perform linting on API specifications, and more.\n\nThe value of centralized API management\n\n\nMany organizations are challenged by the increasing number of APIs that they\ndevelop and use. As the number of APIs increases, they become harder to track,\nwhich can lead to duplication rather than reuse, an expensive inefficiency.\nWhen APIs proliferate without design standards and governance checks, the\nAPI landscape grows inconsistent, slowing teams down, while a well-organized\nAPI program helps them go faster.\n\n\nThe API hub experience is primarily aimed at consumers and producers of APIs\nwithin an organization whose main concerns are finding, listing, comparing, and evaluating APIs\nboth within and external to the organization's network ecosystem.\nAPI hub allows you to manage a complete catalog of all your APIs along with their associated\nentities, including API versions, dependencies, deployments, and more. You can also associate\nAPI specifications with API versions, and for OpenAPI specs, API hub parses them and extracts\nmetadata, including API operations. In addition, you can link an API version to a particular\nAPI deployment endpoint.\n\nKey benefits of Apigee API hub\n\n\nAPI hub administrators can:\n\n- Add, edit and manage a complete catalog of all your APIs along with their associated entities.\n- Manage the entire API lifecycle with support for versioning of APIs, linking versions to API specifications, surfacing the operations parsed from a specification, linking an API version to a particular deployment endpoint, and more.\n- Add attributes to your set of APIs and tag them with various lifecycle stages, compliance information, and other information that you wish to track.\n- Filter and search for APIs based on a rich set of attributes.\n- Link API hub to one or more Apigee and Apigee hybrid projects to automatically fetch Apigee API proxy information and store it in API hub. API hub periodically (once in six hours) runs a scheduler that connects to your Apigee project, and gets the latest proxy definitions.\n- Use powerful semantic search capabilities to find APIs with free-form search.\n- Track compliance for your API specification files using linting functionality.\n- Track dependencies for your APIs by modeling dependencies between various operations in your APIs.\n- Store API life cycle data.\n\n\nWith API hub, you bring rich information about your APIs together into\none place to accelerate the consistency, use, reuse, and governance of your API\nportfolio.\n\nKey features and concepts\n\nAPI resources\n\nAn [API resource](./apis-intro) represents an API that exists within your\norganization's network ecosystem. API\nresources stored in API hub are searchable and provide detailed operational and descriptive\ninformation about the API such as deployments, versions, operations, lifecycle stage, and other key attributes.\n\nVersioning\n\nThe ability to model and organize [API versions](./versions-intro) is a key feature of API hub.\nEvery API resource in API hub has at least one version associated with it. You can\nthink of a version as the state of an API at a point in time. Fundamentally, versions\nhelp you group and organize your APIs based on underlying sets of operations, deployments,\nand other metadata.\n\nAuto-register Apigee API proxies\n\nAuto-registration refers to getting API data from external systems into API hub.\nYou can register all the proxies present in an Apigee or Apigee hybrid runtime project directly in API hub\nby attaching your runtime project to API hub. See [Auto-register Apigee proxies](./auto-register-apigee-proxies).\n\nSpec parsing and linting\n\nAnother key API hub feature is its ability to [parse certain API specifications](./specs-intro),\nsuch as OpenAPI specs, into their contained definitions, operations, and other key components,\nand store that information with an API resource. API hub also provides linting feedback\nfor imported specifications.\n\nSearching\n\nAPI hub's powerful [search capabilities](./search-apis) support both LLM-based\nfree-text and filter-based search operations that let you search based on any part\nof the API definition. These powerful search tools enable you to identify the API asset\nthat serves specific use cases so that you can either avoid rebuilding or duplicating API\nengineering efforts.\n\nAPI supply chain\n\nAPI hub [API supply chain](./api-supply-chain) helps you view and manage the operational\nrelationships or *dependencies* between your APIs. Finding and tracking an API's dependencies\nhelps you manage your API ecosystem more efficiently and troubleshoot broken API operations.\n\nWhat's next?\n\n- [Provision API hub](./provision)\n- [Quickstarts](./quickstart-intro)"]]
