API

별칭: Application Programming Interface · API · 에이피아이 · 외부 API · 공공데이터 API

앱이 다른 프로그램이나 서비스의 기능·데이터를 정해진 방식으로 요청하는 통로.

API는 프로그램끼리 약속된 규칙으로 요청과 응답을 주고받는 인터페이스다. 웹앱에서는 공공데이터를 가져오거나, AI 모델을 호출하거나, 결제·지도·로그인 같은 외부 기능을 붙일 때 API를 사용한다.

정의

API(Application Programming Interface)는 한 프로그램이 다른 프로그램의 기능이나 데이터에 접근할 수 있도록 정해 둔 규칙과 접점이다. 웹에서는 보통 URL로 요청을 보내고 JSON 같은 응답을 받는 HTTP API를 자주 말한다.

왜 중요한가

AI가 만든 첫 화면은 대개 샘플 데이터로만 동작한다. 실제 서비스가 되려면 바깥 세계의 데이터를 받아오거나 다른 시스템의 기능을 호출해야 한다. 지역 행사, 주차장, 병원·약국 같은 공공데이터도 API로 제공되면 웹앱이 최신 정보를 요청해 화면에 반영할 수 있다.

Semiclass에서의 의미

신호의 검 단계는 정적 JSON을 외부 공공데이터 API로 바꾸는 구간이다. 여기서 수강생은 API 키, CORS, 응답 포맷, 서버 route, fallback 샘플 데이터가 왜 필요한지 한 번에 만난다. 핵심은 API 호출 한 줄보다 "외부 응답을 우리 앱의 데이터 타입으로 안전하게 흡수하는 구조"다.

주의할 점

API는 제공자마다 주소, 인증 방식, 요청 파라미터, 응답 형식, 호출 제한이 다르다. API 키를 브라우저 코드에 그대로 넣으면 노출될 수 있으므로 서버 route나 환경변수를 사용해야 한다. 실패했을 때 샘플 데이터로 fallback하는 전략도 초보자 프로젝트에서는 유용하다.

출처