API 검색은 중요한 기능입니다. 그럼에도 종종 간과되는 경향이 있습니다. 그렇다면 검색 기능은 무엇을 말하며, 중요한 이유는 무엇 일까요?
API 검색이란?
검색은 말 그대로 무엇인가 찾는 것입니다. API 검색의 경우 그 대상이 ‘API’가 되는 것입니다. API 검색은 내부와 외부로 경계를 나누어 볼 수 있습니다.
내부는 말 그대로 사내 시스템 또는 클라우드 환경에 있는 서비스를 말합니다. 검색 기능은 개발자가 API를 손쉽게 탐색하여 접근할 수 있도록 돕습니다. 필요 API를 찾아. 앱에 통합하는 데 있어 편의를 제공하는 것이죠. 이 외에도 개발자가 느끼는 편의가 또 있습니다. 바로 중복 개발입니다. 검색 기능이 잘 갖추어져 있으면 개발자 간에 불필요하게 API를 중복해서 빌드하는 것을 막을 수 있습니다. 검색 기능이 없거나 제대로 동작하지 않으면 이미 만들어 놓은 API가 있는 것을 모르고 또 작업을 할 우려가 있다는 소리입니다.
다음으로 외부는 사내 시스템이나 서비스를 외부 개발자와 파트너에게 공개하는 것을 뜻합니다. API 생태계를 떠올리면 이해가 될 것입니다. API 게이트웨이를 구축할 때 개발자 포털을 만들죠. 이 포탈은 내부 개발자뿐 아니라 외부 개발자와 파트너를 위한 것이기도 합니다.
CA API 관리 플랫폼은 마이 데이터 관련 시장에서 가장 높은 시장 점유율을 차지하고 있죠. 많은 조직의 선택을 받은 만큼 기본기가 탄탄합니다. 검색 기능 역시 강력합니다. CA API 관리 플랫폼은 API를 손쉽게 게시하고, 다양한 개발자 그룹에 대한 SLA를 정의하고, API 성능을 모니터링할 수 있는 통합 허브를 제공합니다. 개발자는 카탈로그에서 사용 가능한 API를 쉽게 검색하고, 대화형 문서 및 테스트 도구를 사용해 탐색하고, API에 접근하고, 해당 API를 사용하는 애플리케이션을 관리할 수 있습니다.
검색부터 통합까지 이어지는 편의성
개발자 측면에서 CA API 관리 플랫폼의 검색 기능을 활용하는 예를 소개해 보겠습니다. 새로 팀에 합류한 모바일 앱 개발자가 API를 자신이 만들고 있는 앱에 통합하는 시나리오입니다.
개발 팀 관리자가 이 모바일 앱 개발자를 초대하면, LDAP이나 액티브 디렉토리를 통해 로그인 계정이 제공됩니다. 이 계정에 대한 API 포탈 접근을 관리자가 승인하면 모바일 앱 개발자는 필요 API에 접근할 수 있습니다.
모바일 앱 개발자는 API 포탈에 로그인하여 필요 API를 검색 기능을 이용해 찾습니다. 평소 이용하는 검색 엔진 쓰듯이 키워드를 입력하면 관련 API들이 쭉 나열됩니다. 목록에서 원하는 것을 클릭하면 해당 API 기능을 확인할 수 있습니다.
API를 찾으면 API 기능을 더 잘 이해하고 테스트하여 API 기능과 상호 작용하도록 앱을 설계하는 방법을 더 잘 이해하기 위해 설명서를 보고 싶을 것입니다. CA API 관리 플랫폼은 대화형 문서를 제공합니다. 개발자가 모든 API 리소스를 CRUD 작업(GET, POST, PUT, DELETE)과 함께 사용할 수 있는 방법을 손쉽게 탐색할 수 있습니다. 개발자는 사용 가능한 메서드 및 매개 변수를 확인하고 API에 대한 쿼리를 테스트하여 응답과 작동 방식을 확인할 수 있습니다.
필요 API를 찾고 기능을 확인했다면 개발자는 API에 액세스할 수 있도록 애플리케이션을 등록하면 됩니다. 애플리케이션 추가 작업을 통해 앱에 이름을 지정하고, 추가할 API를 선택하고, EULA에서 해당 API를 사용하는 약관에 동의하고, 승인 및 인증을 위한 OAuth 매개변수를 설정할 수 있습니다. 해당 앱이 등록되면 필요한 API 키를 발급할 관리자 승인 절차가 시작됩니다.
이런 식으로 필요 API 찾아 앱에 통합한 다음 개발자는 언제든지 API 포탈에 로그인하여 앱에 추가 API를 추가하거나 API 또는 앱 성능에 대한 분석을 볼 수 있습니다.
시나리오를 통해 살펴본 바와 같이 개발자가 필요한 모든 것을 찾을 수 있는 중앙 허브를 갖는 것은 생산성과 효율성 측면에서 매우 중요합니다. CA API 관리 플랫폼은 단순 검색 기능을 넘어 개발자와 파트너가 API를 검색하고, 키를 얻기 위해 등록하고, 대화형 문서를 통해 기능과 성능 등에 대한 이해의 폭을 넓힐 수 있는 부분까지 편의를 제공합니다.
Commentaires