List

외부 시스템 연동(API)이란 무엇이고 무엇을 준비해야 하나

#웹가이드

Web GuideAPI 연동ERP 홈페이지 연동외부 시스템 연결

외부 시스템 연동(API)이란 무엇이고 무엇을 준비해야 하나

연동은 마법이 아니라, 두 시스템이 정해진 약속으로 데이터를 주고받는 것입니다.

홈페이지에서 접수된 주문이 사내 ERP로 자동 들어가거나, 지도가 표시되거나, 재고가 실시간으로 보이는 것은 모두 외부 시스템과의 연동으로 이루어집니다.

두 시스템이 데이터를 주고받는 연동 구조
두 시스템이 데이터를 주고받는 연동 구조
01

API가 있어야 연동이 된다

연동하려는 시스템이 외부에서 접근할 수 있는 API를 제공해야 합니다. 네이버 · 카카오 지도, 공공데이터, 주요 PG사, 문자 서비스, 구글 워크스페이스는 API가 공개되어 있습니다.

오래된 사내 ERP나 폐쇄형 프로그램은 API가 없어 연동이 불가능하거나, 파일 교환 방식으로 우회해야 합니다.
02

준비할 것 — 문서, 계정, 담당자

세 가지 중 하나라도 없으면 개발이 멈춥니다. 어떤 데이터를 어떤 형식으로 주고받는지 적힌 API 문서, 실데이터 없이 검증할 수 있는 테스트 계정과 키, 막혔을 때 물어볼 상대 시스템의 기술 담당자입니다.

API 문서 테스트 키 기술 담당자
특히 사내 시스템 연동은 그 시스템을 관리하는 업체와의 협의가 먼저입니다.
연동 개발에 필요한 문서와 인증 키
연동 개발에 필요한 문서와 인증 키
03

방향과 주기를 정한다

홈페이지에서 외부로 보내기만 하는지, 외부 데이터를 가져와 보여주는지, 양방향인지 정합니다. 실시간인지 하루 한 번 일괄인지도 중요합니다.

재고처럼 실시간이 필요한 데이터와 매출 통계처럼 일 단위면 충분한 데이터는 연동 방식이 다르고 비용도 다릅니다.
04

연동 후 유지 책임

외부 서비스가 API를 변경하면 홈페이지 쪽도 수정이 필요합니다. 지도 API 유료화, PG 보안 정책 변경 같은 일이 실제로 일어납니다. 연동 항목이 많을수록 유지보수 계약에 연동 대응이 포함되어야 합니다.

외부 서비스의 변경 공지를 모니터링해, 영향이 예상되면 미리 안내합니다.
CHECK POINT
□  연동 대상 시스템이 API를 제공하는지 확인했는가
□  API 문서 · 테스트 계정 · 상대 담당자를 확보했는가
□  연동 방향과 주기, 이후 유지 책임을 정했는가
연동의 난이도는 개발이 아니라, 상대 시스템의 준비 상태가 결정합니다.
문서 · 계정 · 담당자 세 가지를 먼저 확보하면 일정이 흔들리지 않습니다.
#API 연동 #ERP 연동 #외부 시스템 #공공데이터 #실시간 연동 #업무 자동화
목록보기