Web GuideAPI시스템 연동데이터 교환
API란 무엇인가, 발주자 관점에서
'API로 연동하면 됩니다'라는 말을 자주 듣게 됩니다.
무엇인지 알면 연동 견적과 일정을 이해할 수 있습니다.
01시스템 간의 창구
API는 두 시스템이 정보를 주고받는 약속된 창구입니다. 사람이 화면을 보고 입력하는 대신, 프로그램끼리 직접 데이터를 교환합니다.
예를 들어 홈페이지에서 주소를 검색하면, 주소 데이터를 가진 외부 시스템에 물어보고 결과를 받아옵니다.
01
주소 검색
주소 데이터베이스에 물어보고 결과를 받습니다.
02
결제
결제 대행사에 요청하고 결과를 받습니다.
03
지도
지도 서비스에서 지도와 경로를 가져옵니다.
04
문자·알림톡
발송 서비스에 보낼 내용을 전달합니다.
05
사내 시스템
ERP나 CRM과 데이터를 주고받습니다.
02제공하는 쪽과 쓰는 쪽
우리가 외부 서비스의 API를 쓰는 경우와, 우리가 API를 만들어 제공하는 경우가 있습니다. 후자가 훨씬 어렵습니다.
제공하려면 보안, 인증, 사용량 관리, 문서화까지 필요합니다.
외부 API 사용
상대가 만들어 둔 것을 씀 · 문서를 보고 연결 · 상대적으로 간단 · 상대 서비스에 의존
API 제공
우리가 만들어 남에게 제공 · 보안과 인증 필요 · 사용량 관리 · 문서화 · 별도 프로젝트에 가깝습니다
03연동이 어려워지는 경우
API가 있다고 해서 연동이 항상 쉬운 것은 아닙니다. 상대 시스템의 상태에 따라 크게 달라집니다.
특히 오래된 사내 시스템은 API가 없거나 문서가 없는 경우가 많습니다.
API가 없음
만들어야 합니다. 상대 시스템 개발이 필요합니다.
문서가 없음
어떻게 쓰는지 파악하는 데 시간이 걸립니다.
담당자가 없음
물어볼 사람이 없으면 진행이 막힙니다.
사내망 전용
외부에서 접근할 수 없으면 별도 조치가 필요합니다.
보안 정책
외부 연결이 금지된 경우도 있습니다.
상대 시스템 불안정
자주 멈추면 우리 사이트도 영향을 받습니다.
04확인할 것
연동 견적을 받기 전에 상대 시스템 상태를 확인해야 합니다. 이것이 불확실하면 견적도 불확실해집니다.
제작사가 상대 시스템을 직접 확인할 수 있게 연결해 주는 것이 좋습니다.
API 존재 여부있는지, 없으면 만들 수 있는지.
문서 확보명세서가 있는지. 없으면 기간이 늘어납니다.
담당자 연결상대 시스템 담당자나 업체와 소통할 수 있는지.
테스트 환경실제 데이터 말고 테스트용 환경이 있는지.
장애 시 대응상대 시스템이 멈추면 우리 사이트가 어떻게 되는지.
사용량 제한외부 서비스는 호출 횟수 제한과 비용이 있을 수 있습니다.
CHECK POINT
□ 연동할 시스템에 API가 있는지 확인했는가
□ API 문서가 있는가
□ 상대 시스템 담당자와 소통할 수 있는가
□ 테스트 환경이 있는가
□ 사내망 접근 문제를 확인했는가
□ 상대 시스템 장애 시 대응 방식을 정했는가
□ 외부 서비스의 사용량 제한과 비용을 확인했는가
#API#시스템 연동#데이터 교환#외부 서비스#사내 시스템#연동 견적#테스트 환경#홈페이지 개발#웹비스타#홈페이지 제작