DEFINITIONAPI란?
API는 서로 다른 프로그램이 정해진 규칙에 따라 데이터를 주고받을 수 있게 열어 둔 연결 통로입니다.
API · Application Programming Interface · 최종 수정 · 작성 시스템메이트 개발팀
DETAIL자세히 알아보기
예를 들어 쇼핑몰이 택배사 API를 호출하면 송장 번호를 자동으로 받아오고, 오픈마켓 API를 호출하면 새 주문을 가져올 수 있습니다. 사람이 화면을 오가며 옮겨 적던 일을 프로그램끼리 처리하게 만드는 것이 API 연동 개발입니다.
예시 · 쿠팡 Open API로 주문 수집, 토스페이먼츠 API로 결제 승인, 카카오 알림톡 API로 배송 안내 발송
KEY POINTSAPI 핵심 포인트
- 01요청과 응답
프로그램이 정해진 주소로 요청을 보내면, 상대 서비스가 약속된 형식(주로 JSON)으로 결과를 돌려줍니다.
- 02인증
API 키 · 토큰 · 서명으로 허가된 프로그램만 데이터에 접근하게 합니다.
- 03사용 한도
대부분의 API는 초당 · 일별 호출 횟수 제한이 있어 이를 고려해 설계합니다.
- 04오류 처리
응답 실패 · 토큰 만료에 대비해 재시도와 알림을 둡니다.
WHEN이럴 때 필요합니다
- 같은 데이터를 두 프로그램에 반복 입력하고 있을 때
- 외부 서비스(결제 · 배송 · 메시지)를 우리 시스템에 붙이고 싶을 때
- 거래처 · 파트너에게 우리 데이터를 안전하게 제공해야 할 때
CASES사례로 보는 API
오픈마켓 통합 발주 자동화
판매 채널이 늘수록 관리자 화면에 로그인해 주문을 내려받는 시간이 늘던 판매 사업자를 위해, 채널별 API 연동을 모듈로 분리했습니다. 이제 채널이 추가돼도 연동 모듈만 더하면 되고 주문 수집 시간은 늘지 않습니다.
포트폴리오에서 보기 · 오픈마켓 통합 발주 자동화 플랫폼단축URL 서비스의 외부 연동 API
마케팅 링크 성과를 측정하는 단축URL 서비스에 REST API를 만들어, 외부 시스템이 API 키로 인증한 뒤 링크를 직접 생성하고 클릭 통계를 가져가도록 했습니다.
포트폴리오에서 보기 · 단축URL + 클릭 분석 + A/B 테스트 플랫폼FAQAPI 자주 묻는 질문
QAPI 연동은 한 번 만들면 계속 쓸 수 있나요?
대부분 그렇지만, 상대 서비스가 API 버전을 바꾸거나 정책을 변경하면 수정이 필요합니다. 그래서 오류 감시와 유지보수 계획을 함께 세웁니다.
QAPI 키가 유출되면 어떻게 되나요?
다른 사람이 우리 권한으로 데이터를 조회 · 변경할 수 있으므로 즉시 키를 재발급해야 합니다. 키는 소스코드가 아닌 서버 설정 파일에 두고 접근 권한을 최소화합니다.