[SQA] API 유형별 4가지 종류와 차이점 정리 | Private / Public / Partner / Composite API

📌 API란?

Application Programming Interface
응용 프로그램이 서로 데이터를 주고받을 때 사용하는 인터페이스입니다.
예) 모바일 앱 ↔ 서버 / 웹 서비스 ↔ 데이터베이스 등

---

✅ 대표적인 API 유형 분류 4가지

• 1️⃣ Private API
• 2️⃣ Public API
• 3️⃣ Partner API
• 4️⃣ Composite API

---

1️⃣ Private API

🔍 특징

• 조직 내부에서만 사용하는 API
• 일반 사용자나 외부 개발자에게 공개되지 않음
• 내부 시스템 간 데이터 공유, 기능 호출에 사용

💡 장점

• 보안성 높음 (외부 노출 X)
• 내부 시스템 간 최적화된 성능 가능
• 관리가 용이

⚠️ 단점

• 외부 파트너 활용 불가
• 개발 문서가 폐쇄적일 수 있음

✅ 예시 활용

• 기업 내부 ERP ↔ CRM 시스템 연동
• 사내 모바일 앱 ↔ 내부 서버 API
• 내부 데이터 분석 플랫폼 API

---

2️⃣ Public API (Open API)

🔍 특징

• 모든 개발자에게 공개된 API
• 누구나 접근 가능 (회원가입이나 인증 후 이용 가능)
• 보통 공식 문서와 예제가 잘 제공됨

💡 장점

• 생태계 확대 가능 (외부 개발자 활용)
• 서비스 홍보 및 사용성 증가
• 서드파티 서비스 개발 촉진

⚠️ 단점

• 보안 위협 노출 가능성
• API 남용 가능성 있음 → 모니터링 필요

✅ 예시 활용

• 네이버 Open API
• 구글 맵 API
• 카카오 로그인 API
• 공공데이터 포털 API

---

3️⃣ Partner API

🔍 특징

• 특정 파트너(제휴사)에게만 제공하는 API
• Public API처럼 전면 공개하지 않음
• 계약된 파트너사에 한정해 접근 권한 제공

💡 장점

• 파트너사와 안정적 협업 가능
• 기능, 데이터 접근 범위를 세밀하게 관리 가능
• 수익화 전략으로 활용 가능

⚠️ 단점

• 파트너사 관리 필요
• API 변경 시 파트너사와 조율 필수

✅ 예시 활용

• 카드사 ↔ 쇼핑몰 결제 연동 API
• 숙박 OTA(여행사) ↔ 호텔 예약 API
• B2B 서비스 ↔ 파트너사 재고 연동 API

---

4️⃣ Composite API

🔍 특징

• 여러 API 호출을 하나의 요청으로 처리
• 여러 데이터 소스를 한 번에 통합 호출
• 주로 마이크로서비스 아키텍처에서 사용

💡 장점

• 네트워크 비용 절감
• 클라이언트 성능 개선
• API 호출 횟수 최소화

⚠️ 단점

• 설계 복잡성 증가
• 통합 로직이 변경되면 전체 테스트 필요

✅ 예시 활용

• 모바일 앱 초기 화면 데이터 한번에 로드
• 대시보드에서 다양한 지표 데이터 한번에 조회
• BFF(Backend For Frontend) 패턴 적용 시 사용

---

📚 참고 자료

• https://www.redhat.com/en/topics/api/what-are-application-programming-interfaces
• https://swagger.io/resources/articles/different-types-of-apis/
• https://www.ibm.com/cloud/learn/api

---

📌 마무리

이번 글에서는 API 유형별 분류 4가지 (Private, Public, Partner, Composite API) 에 대해 정리해보았습니다.
API를 설계하거나 테스트할 때, 각 유형의 특징과 활용 목적을 잘 이해하고 적용하는 것이 중요합니다.
앞으로도 SQA와 API 테스트 관련 내용을 꾸준히 정리해볼 예정이니, 다음 포스팅도 기대해주세요! 🚀