API 쉽게 이해하기
개발자와 회의하다 보면 API라는 단어를 종종 듣게 됩니다. 공부 겸 API란 무엇인지 쉽게 풀어 정리해 보겠습니다.
API란?
위키백과에 설명하고 있는 API의 사전적 정의는 아래와 같습니다.
API(Application Programming Interface, 응용 프로그램 프로그래밍 인터페이스)는 응용 프로그램에서 사용할 수 있도록, 운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스를 뜻한다. 주로 파일 제어, 창 제어, 화상 처리, 문자 제어 등을 위한 인터페이스를 제공한다.
무슨 내용인지 전문가가 아닌 이상 이해하기 쉽지 않습니다. 레스토랑을 예로 들어보겠습니다.
레스토랑에서…
손님은웨이터를 불러 음식을 주문합니다.웨이터는셰프에게 음식을 요청합니다.셰프는 요리가 끝난 후웨이터에게 음식을 전달합니다.웨이터는손님에게 주문한 음식을 제공합니다.
위 상황에서 손님은 메뉴에 있는 음식을 요청하는 응용 프로그램이라면 셰프는 요리를 만들어 전달하는 운영 체제라고 할 수 있습니다. 이 둘을 연결해주는 웨이터가 바로 API입니다. 조금 더 생각해보면 메뉴는 API의 인터페이스라고 할 수 있습니다.
API 어떻게 사용할까
API를 어떻게 쓰는지 예를 들어 작성해 보겠습니다.
먼저 무료로 사용할 수 있는 오픈 API 사이트 몇 곳을 소개합니다.
API를 무료로 이용할 수 있다고 해도 본인 인증할 수 있는 키가 필요하며, 몇 번까지 무료 초과 이용 시 유료인 API도 있습니다.
- 공공데이터포털 : https://www.data.go.kr/
- Kakao Developers : https://developers.kakao.com/
- Naver Developers : https://developers.naver.com/
- OpenWeatherMap : http://openweathermap.org/
날씨 정보를 제공하는 OpenWeatherMap의 API를 이용해 런던의 날씨 정보를 알아보겠습니다.
API 사용하기
레스토랑의 이야기를 토대로 설명해보자면, 런던의 현재 날씨를 보여주는 응용 프로그램을 만들기 위해 OpenWeatherMap 이라는 운용 체제의 API를 통해 정보를 제공 받게 됩니다.
jQuery 예제
현재 날씨 정보를 받아오기 위한 API 주소는 아래와 같은 형식으로 구성됩니다. 🔗
var api = "//api.openweathermap.org/data/2.5/weather?q=지역&appid=인증키";
jQuery.getJSON()를 이용하여 요청한 API 정보를 HTML 내 출력하는 예시를 작성해 보았습니다.
See the Pen OpenWeatherMap API Sample by moonspam (@moonspam) on CodePen.
정리
API는 어렵고 복잡한 과정을 쉽게 전달받을 수 있도록 만들어주는 다리 역할을 해줌으로써 작업을 빠르고 간결하게 진행할 수 있습니다. 👍👍👍
