결론부터: '연동 지원'은 마케팅 문구일 수 있다
벤더 소개 페이지에 'API 연동 지원'이라고 적혀 있어도, 그 말만으로는 실제 업무에 쓸 수 있는 수준의 연동인지 알 수 없다. API가 존재한다는 것과, 우리 조직이 필요로 하는 데이터를 원하는 방식·주기로 주고받을 수 있다는 것은 다른 문제다. 계약 전에는 '연동 가능 여부'가 아니라 '연동 범위와 조건'을 확인해야 한다.
문서상 연동과 실제 연동의 차이
벤더가 API를 제공한다고 해도 다음과 같은 간극이 흔하게 발생한다.
- 읽기 전용 API: 데이터를 조회만 가능하고, 외부에서 데이터를 밀어넣는 쓰기(write) 기능은 없는 경우가 있다.
- 일부 모듈만 개방: 전체 기능 중 특정 모듈(예: 사용자 목록)만 API로 열려 있고, 핵심 업무 데이터는 비공개인 경우가 있다.
- 플랜별 제한: 하위 요금제에서는 API 자체가 비활성화되어 있거나, 호출 횟수·연동 가능 대상 수가 제한되는 경우가 많다. 이는 제조사 요금제 공지에서 확인해야 한다.
- 버전 불일치: 영업 담당자가 설명하는 기능이 최신 API 버전 기준이 아니라 로드맵(개발 예정) 단계인 경우도 있다.
이런 차이는 계약서나 소개 자료만 봐서는 드러나지 않는다. 실무자가 직접 기술 문서를 확인하거나, 테스트 환경에서 호출해 봐야 알 수 있다.
계약 전 확인해야 할 7가지 항목
- API 문서 공개 여부: 로그인 없이도 API 레퍼런스 문서를 열람할 수 있는지 확인한다. 문서가 공개되지 않고 '영업팀 문의' 안내만 있다면, 연동 난이도가 높거나 지원이 제한적일 가능성을 염두에 둔다.
- 인증 방식: API 키 방식인지, OAuth 2.0 같은 표준 인증인지 확인한다. 내부 보안 정책상 특정 인증 방식을 요구하는 조직이라면 이 부분이 걸림돌이 될 수 있다.
- 요청 제한(Rate Limit): 분당·일당 호출 횟수 제한이 있는지, 제한 초과 시 어떤 방식으로 처리되는지 확인한다. 구체적인 수치는 벤더 기술 문서에서 확인해야 한다.
- 웹훅(Webhook) 지원: 실시간 데이터 반영이 필요한 업무라면, 주기적으로 데이터를 긁어오는 폴링(polling) 방식만 지원하는지, 이벤트 발생 시 알려주는 웹훅을 지원하는지가 중요하다.
- 플랜별 기능 차이: API 연동이 모든 요금제에서 동일하게 제공되는지, 상위 플랜에서만 열리는 기능인지 요금 페이지와 기술 문서를 교차 확인한다.
- 샌드박스·테스트 환경 제공 여부: 실제 결제 전에 테스트용 계정이나 환경에서 연동을 시도해 볼 수 있는지 확인한다. 테스트 없이 바로 본계약으로 넘어가는 구조라면 리스크가 크다.
- 연동 실패 시 책임 소재: 계약서나 서비스 약관에 API 중단·버전 변경에 대한 사전 고지 의무, 장애 시 보상 조항이 있는지 확인한다. 세부 조항 해석이 어렵다면 법무 담당자나 전문가의 검토를 받는 것이 안전하다.
비교 기준표
| 확인 항목 | 왜 중요한가 | 확인 방법 |
|---|---|---|
| 문서 공개 여부 | 연동 난이도와 투명성을 가늠 | 공식 API 레퍼런스 페이지 확인 |
| 인증 방식 | 내부 보안 정책과의 적합성 | 기술 문서, 개발팀 검토 |
| 요청 제한 | 대량 처리 업무에 지장 여부 | 요금제·기술 문서 교차 확인 |
| 웹훅 지원 | 실시간성 요구 업무 가능 여부 | 기술 문서, 영업 담당자 질의 |
| 플랜별 차이 | 실제 결제할 플랜에서 연동 가능한지 | 요금 페이지 세부 조항 확인 |
| 샌드박스 제공 | 계약 전 검증 가능 여부 | 무료 체험·테스트 계정 요청 |
| 장애·변경 고지 조항 | 운영 중 리스크 관리 | 서비스 약관, 법무 검토 |
실무 체크리스트
- 벤더 공식 API 문서 링크를 받아 개발팀 또는 연동 담당자가 직접 열람한다.
- 우리 조직이 필요로 하는 구체적 시나리오(예: '주문 데이터를 실시간으로 받아 내부 시스템에 반영')를 적어 벤더에 질의한다.
- 테스트 계정이나 샌드박스 환경 제공 여부를 문의하고, 가능하면 실제 호출 테스트를 해본다.
- 요금제별 API 제한 사항을 요금 페이지에서 직접 확인하고 영업 설명과 비교한다.
- 계약서에 연동 관련 장애·변경 고지 조항이 있는지 확인하고, 필요하면 법무 전문가에게 검토를 요청한다.
이 과정을 생략하고 '연동 지원'이라는 문구만 믿고 계약하면, 실제 도입 단계에서 개발 리소스가 추가로 투입되거나 원하는 업무 자동화가 불가능하다는 것을 뒤늦게 발견할 수 있다.