API 는 식당 메뉴판 같은 것 — 주방 안을 몰라도 메뉴대로 주문하면 음식이 나오듯, 프로그램끼리 정해진 방식으로 서로의 기능을 가져다 쓰는 약속.
API 는 두 프로그램이 서로 대화하는 창구라고 생각하면 됩니다. 카페에서 바리스타에게 직접 에스프레소 머신을 만지지 않아도 '아이스 아메리카노 한 잔'이라고 주문하면 음료가 나오죠. API 도 마찬가지입니다 — 상대 프로그램의 내부 구조를 전혀 몰라도, 정해진 요청 (Request) 을 보내면 정해진 응답 (Response) 이 돌아옵니다.
1인 비즈니스(1인 사이트 운영)를 운영하다 보면 API 는 생각보다 훨씬 자주 등장합니다. 블로그에 날씨 위젯을 붙이려면 기상청 API 에 요청을 보내야 하고, 뉴스레터 구독자를 관리하는 서비스와 내 사이트를 연결할 때도 API 를 씁니다. 쇼핑몰에서 결제를 처리하거나, 커뮤니티에서 소셜 로그인 (Social Login) 을 구현하거나, SaaS 대시보드에서 외부 데이터를 가져올 때도 모두 API 가 중간에서 다리 역할을 합니다. 즉, 내가 직접 모든 기능을 만들지 않아도 이미 만들어진 기능을 API 로 빌려 쓸 수 있는 것이 핵심입니다.
초보가 가장 혼동하는 점은 'API 키 (API Key)' 입니다. API 키는 내가 그 서비스를 사용할 권한이 있다는 일종의 비밀 출입증인데, 이것이 외부에 노출되면 타인이 내 이름으로 API 를 마구 호출해 요금이 청구되거나 데이터가 유출될 수 있습니다. API 키는 반드시 환경변수 (Environment Variable) 에 저장하고 코드에 직접 적어두지 않는 습관을 처음부터 들이는 것이 좋습니다.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.
