이 글의 목차
먼저 알아둘 답
홈페이지를 다른 프로그램과 API로 연결하려면 무엇이 필요한가요?
다른 프로그램과 정보를 주고받으려면 상대 서비스가 제공하는 연결 방법과 사용 권한을 확인해야 합니다. 이 연결 방법을 API라고 합니다. 연결에 성공한 뒤에도 자료가 맞게 들어오는지, 오류나 중복 요청을 어떻게 처리하는지와 이용료를 확인해야 합니다.
택배 조회: 주문번호와 운송장 번호를 연결하기
쇼핑몰 고객에게 배송 현황을 보여주고 싶지만 택배사와 쇼핑몰은 별도 프로그램입니다.
이렇게 바꿔보세요
택배사가 허용하는 연결 방식으로 운송장 상태를 받아 주문 화면에 표시합니다. 조회 제한이나 일시 장애 때는 마지막 확인 시각과 다시 확인할 방법을 안내합니다.
API는 프로그램끼리 정해진 형식으로 정보를 주고받는 통로입니다. 연결 권한과 제한을 먼저 확인해야 합니다.
내 사업에서 확인할 일
연결할 업체, 받고 싶은 정보, 하루 조회량을 정리하세요.
이 글에 나오는 용어3개 · 뜻과 예시 보기
낯선 용어는 아래 뜻과 예시를 참고하세요.
- API다른 프로그램과 정보를 주고받는 연결 창구
-
프로그램끼리 정해진 요청과 응답으로 정보를 주고받는 방법입니다. 제공된 기능, 사용 권한과 비용을 확인해야 합니다.
예를 들면 홈페이지에서 배송 상태를 보여주려면 배송 서비스가 제공하는 연결 방법을 확인합니다.
- 인증누가 접속했는지 확인하는 절차
-
로그인 등으로 사용자의 신원을 확인하는 일입니다. 신원을 확인한 뒤 어떤 자료를 볼 수 있는지 정하는 권한 설정과는 구분합니다.
예를 들면 직원으로 로그인했다고 모든 고객 정보나 모든 부서의 자료를 볼 수 있게 하지는 않습니다.
- 재시도실패한 작업을 정한 조건에 따라 다시 하는 것
-
연결 오류 등이 났을 때 다시 요청하는 처리입니다. 중복 주문·결제·알림이 생기지 않도록 결과 확인과 반복 기준을 정해야 합니다.
예를 들면 응답이 없다고 결제를 무조건 다시 요청하지 않고 실제 승인 여부를 확인합니다.
먼저 알아둘 점: 외부 API 통합
같은 데이터 이름이라도 시스템마다 상태, 시간, 식별자가 다를 수 있습니다. 어느 값이 기준인지와 누가 변경할지를 먼저 정하세요. API가 없거나 이용 조건이 맞지 않으면 연결 방식을 확정할 수 없으며 비밀번호 등 계정 인증정보를 공개 JavaScript에 넣지 않습니다.
결정 전에 비교할 기준
| 확인할 조건 | 판단과 작업 범위 |
|---|---|
| 연결 조건 | 문서, 사용 권한, 계정, 이용료, 호출 제한 |
| 데이터 기준 | 식별자, 필드, 상태, 시간, 우선 시스템 |
| 오류, 운영 | 재시도, 중복, 기록, 알림, 복구 |
직접 확인할 체크리스트
- 정상, 누락, 잘못된 응답을 처리하는지
- 중복 호출이 중복 업무를 만들지 않는지
- 실제 권한과 비밀키가 보호되는지
- 관리자가 실패, 재처리 상태를 확인하는지
이 자료가 있으면 상담이 구체적입니다
- 실제 API 문서, 조건
- 개인정보를 지운 입출력 예시 자료
- 연결할 업무, 운영 담당자
YOUR NEXT STEP WITH 짓고 JiTGO
반복 업무를, 관리할 수 있는 시스템으로.
입력 자료와 업무 규칙, 실패·재처리 흐름을 정리해 필요한 부분부터 개발합니다.
- 만들 기능·제작할 내용·비용을 먼저 확인
- AI의 효율과 개발자의 최종 확인
- 진단·상담 모두 무료
- 모든 개발 완료 후 원천 소스 제공
- 프로젝트별 별도 견적·계약
예약·결제·회원·챗봇·장비 연동 등 맞춤 개발에는 기본형 홈페이지의 30만 원 가격과 후불 조건이 자동 적용되지 않습니다.
