[PM온보딩] 참고자료 4 : 외부 API
외부 API란 무엇일까요?
외부 API는 우리가 만드는 서비스에서 특정 기능을 직접 개발하지 않고, 다른 플랫폼에서 제공하는 기능을 불러와 사용하는 방법을 말합니다.
많은 서비스에서
간편 로그인을 제공하기 위해 소셜로그인 방식들을 이용하는데요. 구글로 로그인하기, 카카오톡으로 로그인하기를 구현하기 위해서는 구글과 카카오에서 제공하는 API를 통해 진행해야 합니다. 그 외에 카카오톡으로 알림을 보내거나, PG사 연동으로 결제를 처리하는 기능도 외부 API로 볼 수 있습니다.
소셜 로그인 및 사용자 인증 : Kakao, Google, Apple, Naver 등
결제 : KG이니시스, NICE페이먼츠, 토스페이먼츠 등
알림톡, 문자 발송 : 카카오 알림톡, Naver 클라우드 플랫폼, 쿨 에스엠에스 등
주소 검색, 지도 맵 : Kakao Map, Naver Map, Google Map 등
채팅/ 상담 : 채널톡, 샌드버드 등
마케팅/분석 :Google Analytics 등
스케줄/문서 연동 : Notion API, Google Calendar API
데이터/공공 : DART, KRX
실제 서비스에서 외부 API가 사용된 사례를 가져와봤어요.
소셜 로그인 API
회원가입 및 로그인 절차를 간소화하여 사용자 전환율 향상과 초기 이탈률 감소에 효과적입니다.
위 사례에서 사용된 외부 API
카카오 API
네이버 API
애플 로그인 API (iOS 앱 필수)
-> IOS 앱 정책의 경우 : 소셜로그인이 하나라도 존재한다면 애플 로그인도 필수로 진행되어야 합니다.
페이스북 API
29CM의 경우
로그인 진입 시 소셜 계정을 선택할 수 있게 배치하였습니다.
사용자가 마지막으로 로그인했던 소셜 로그인 수단을 ‘최근 로그인’ 배지 노출을 통해 접근성을 높였습니다.
PM 체크포인트
각 플랫폼 API 연동 정책 숙지 필요
-> ex) 애플 로그인은 iOS 앱일 경우 필수 / 카카오는 비즈 앱 등록 필요
활용될 사용자 정보 범위 확인 필요
-> ex) 닉네임, 이메일, 고유 ID 등 정보 리스트 사전 협의 필요
각 플랫폼 별 스타일 가이드가 상이하므로 선 검토 필요
소셜 로그인은 가장 보편적으로 사용하는 외부 API 중 하나입니다.
각 플랫폼의 API 연동 가이드를 참고하여, 기획적으로 고려해야 할 사항들을 검토하는 것이 중요합니다.
외주 에이전시의 경우, 고객사의 계정을 필요로 하기에 API 연동을 위해 필요한 계정을 미리 세팅하는 것이 중요합니다.
결제 API
결제 API는 온라인 결제 기능을 구현하기 위해 사용되며, 신용카드 결제, 간편 결제, 정기결제 등의 수단을 제공합니다.
위 사례에서 사용된 외부 API
위 이미지는 에이블리의 카드 결제 화면이며, NICE페이먼츠의 API를 연동한 것을 알 수 있습니다.
NICE페이먼츠, KG이니시스, 토스페이먼츠, KCP -> PG사
토스페이, 네이버페이, 페이코, 카카오페이 등 -> 간편 결제의 종류
PM 체크포인트
결제 방식에 따른 구조 이해
-> 정기결제 vs. 일회성 결제, 간편 결제 여부에 따라 연동 방식 및 요구사항이 다릅니다.
결제 후 결제가 성공하거나 실패했을 경우 정의 필요
약관 및 개인정보 동의 검토 필요
-> 각 PG사마다 요구하는 동의 항목이 다르므로, 사전에 화면 구성과 법적 요구사항을 확인해야 합니다.
결제 API는 다양한 카드사가 존재하며 심사를 거쳐야 합니다. 실물 상품을 결제하는 것인지, 최대 가격은 얼마인지, 상품의 카테고리는 무엇인지, 예상 매출액 등 입점 가능 여부 판단을 위한 요건들이 존재하니, 사전에 검토하여 일정 관리를 하는 것이 중요합니다.
특히 개인정보 이슈가 동반되기 때문에 법적 준수사항과 카드사 가이드를 검토해야 합니다. 단순 연동 여부만이 아닌, 사업/보안/UX를 전체적으로 고려한 체크가 필요합니다.
알림톡 API
회원가입, 결제, 배송, 주문 등 주요 이벤트 발생 시 실시간으로 메시지를 전송해 줍니다.
위 사례에서 사용된 외부 API
위 이미지는 배달의민족에서 보낸 메시지입니다. 유저가 주문 완료 시 → 카카오톡으로 메시지를 발송하고 있음을 알 수 있습니다.
채팅의 형태가 아닌 알림 형태의 메시지입니다.
PM 체크포인트
초기 인증 및 발신 프로필 등록 필요
-> 카카오 비즈니스 센터를 통해 서비스 등록과 발신번호, 발신자명, 템플릿 심사를 받아야 합니다.
최초 사용자 제한 조건과 같은 정책 확인 필요
발송 조건 정의 필요
-> 예: 주문 완료 시 1회만 발송 / 재발송 조건은 없음
-> 사용자 상태값 변화에 따라 메시지가 발송되는 타이밍 정의 필요
템플릿 문구 사전 등록과 관리 필요
알림톡 비용 구조 확인 및 안내 필요
메시지를 언제 발송하고, 어떤 조건에서 실패할 수 있는지, 실패했을 때 어떻게 대응할 것인지 와 같은 흐름을 미리 그려보고 정의하는 것이 중요합니다.
지도 API
배달, 만남 장소 지정, 상점 위치 안내 등에서 활용됩니다. 직거래 플랫폼, 배달 서비스, 택시 호출 앱 등에서 지도는 필수적입니다.
위 사례에서 사용된 외부 API
위 이미지는 당근마켓입니다. 화면 하단에 애플 지도가 임베드되어 위치를 시각적으로 보여주고 있습니다.
이 외에도 아래와 같은 지도 API가 있습니다.
카카오 지도 API
네이버 지도 API
Apple 지도 API
Google Maps API
PM 체크포인트
제한 정책 확인 필요
-> 대부분의 지도 API는 월별 요청 횟수 제한이 존재합니다. 트래픽 증가 시 과금이 발생할 수 있습니다.
상업용 라이선스 전환 여부 사전 확인 필요
기기/OS 호환성 확인 필요
-> Apple 지도는 iOS 전용이며, 안드로이드 중심일 경우 카카오/네이버 지도가 유리할 수 있습니다.
사용자 위치 접근 권한 설정 필수
-> 앱 설정에서 위치 접근 허용 / 거부 시의 예외처리 고려 필요
고객센터용 채팅 API
문의사항 접수, 자동 응답, 상담 연결과 같은 CS 대응을 위해 활용됩니다. 사용자 문의 경로를 단순화하고 효율을 높일 수 있습니다.
위 사례에서 사용된 외부 API
Channel.io 즉, 채널톡 사례를 가져왔습니다. 화면 하단 플로팅을 통해 쉽게 접근할 수 있도록 하였습니다. 클릭 시 채팅창이 열리며, 문의할 수 있습니다.
PM 체크포인트
대부분 유료 플랜이기에 비용 확인 필요
카카오 챗봇 등 일부 API는 공식 심사 절차가 존재하기에 정책 확인 필요
FAQ 템플릿 등록 및 알림 메시지 커스터마이징 등 정의 필요
연동 비용, 심사, 문의 시나리오를 사전에 정의하는 것이 중요합니다.
외부 API는 각 플랫폼마다 정책과 개발 가이드가 다르기에, 사전 검토가 무엇보다 중요합니다.
같은 ‘결제’ 기능이라도 어느 PG사와 연동하느냐, 어떤 결제 방식을 선택하느냐에 따라 기획은 물론, 디자인·보안·운영 전반에 걸쳐 구조가 달라질 수 있습니다.
PM은 무엇을 준비해야 하고, 어떤 흐름으로 서비스에 녹여낼지 미리 로드맵을 그려보는 자세가 필요합니다.
