API는 우체국이다

시민 앱 제작 7차시 — AI 엔진 연결의 원천기술

레스토랑에서 이해하는 API

API를 이해하는 가장 좋은 비유는 레스토랑입니다:

손님은 주방에 들어갈 필요가 없습니다. 웨이터(API)에게 원하는 것을 말하면, 웨이터가 주방에 전달하고 결과를 가져다줍니다. API(Application Programming Interface)는 이 "웨이터"의 역할을 하는 기술 표준입니다.

1960년대: 서브루틴의 시대

API의 조상은 서브루틴(Subroutine)입니다. 1960년대, 프로그래머들은 같은 코드를 반복해서 작성하는 것에 지쳤습니다. "자주 쓰는 기능을 한 번 만들어놓고, 이름만 불러서 쓰자"는 아이디어가 서브루틴입니다.

이것이 확장되어 "다른 프로그램의 기능을 이름만 불러서 쓰자"가 되었고, 다시 확장되어 "다른 회사의 서버에 있는 기능을 이름만 불러서 쓰자"가 되었습니다. 이것이 현대 API입니다.

오늘날: API 경제의 시대

현대 웹은 API 없이 작동할 수 없습니다. 일상 속 API 사용 예시:

• 카카오맵 앱에서 길찾기 → 구글 지도 API 또는 카카오 지도 API 호출
• 쇼핑몰 결제 → 토스/카카오페이 결제 API 호출
• 날씨 앱 → 기상청 공공데이터 API 호출
• ChatGPT 앱 → OpenAI API 호출

API 키: AI를 부르는 열쇠

대부분의 API는 API 키(API Key)를 요구합니다. 이것은 레스토랑의 예약 번호와 같습니다. "이 사람은 우리 서비스를 사용할 권한이 있다"는 인증입니다.

7차시에서 여러분이 Google AI Studio에서 발급받는 API 키가 바로 이것입니다. 이 열쇠 하나로 구글의 Gemini AI 두뇌를 여러분의 웹앱에서 호출할 수 있게 됩니다.