비전공자를 위한 API 입문 - 프로그램끼리 대화하는 법

API, 이름은 많이 들었는데 실체가 궁금하신가요

“API 연동만 하면 된다”는 말, 회의 중에 한 번쯤 들어보셨을 겁니다. 그런데 막상 API가 정확히 무엇인지 물어보면 설명하기가 애매합니다. 개발자들끼리만 아는 전문 용어처럼 느껴지지만, 사실 API는 개념 자체는 어렵지 않습니다. 오히려 비전공 실무자가 알아두면 업무 자동화의 폭이 크게 넓어지는 도구입니다.

이 글에서는 API가 무엇인지, 왜 실무에 필요한지, 그리고 파이썬으로 어떻게 처음 써보는지를 순서대로 정리합니다. 비전공 사무직을 위한 코딩 입문 로드맵에서 다룬 학습 방향의 다음 단계로 읽으셔도 좋습니다.

API란 무엇인가

API(Application Programming Interface)는 쉽게 말해 “프로그램끼리 정보를 주고받는 약속된 방식”입니다. 식당에 비유하면 이해가 빠릅니다. 손님(우리 프로그램)이 주방(다른 회사의 시스템)에 직접 들어가서 요리하지 않고, 종업원(API)에게 주문서를 건네면 종업원이 주방에서 음식을 받아다 줍니다.

실무에서 흔히 만나는 예시는 다음과 같습니다.

날씨 정보를 가져와서 사내 게시판에 자동으로 표시하기
공공데이터포털에서 통계 자료를 자동으로 받아오기
사내 그룹웨어와 외부 메신저를 연동해서 알림 보내기
환율 정보를 실시간으로 받아 견적서에 반영하기

이 모든 작업의 공통점은 “우리가 직접 데이터를 만들지 않고, 이미 존재하는 데이터를 정해진 방식으로 요청해서 받아온다”는 것입니다.

왜 비전공 실무자에게도 필요한가

엑셀로 데이터를 정리하다 보면 매번 외부 사이트에 접속해서 값을 복사해 붙여넣는 일이 반복됩니다. 환율, 주가, 공공데이터, 날씨 같은 정보가 대표적입니다. 이런 작업은 API를 활용하면 자동화할 수 있습니다.

이미 엑셀 반복 업무, 파이썬으로 10분 만에 끝내기에서 사내 파일을 자동으로 취합하는 방법을 다뤘다면, API는 그 범위를 사외 데이터까지 넓히는 단계입니다. 파일을 손으로 열어보지 않아도 외부 정보를 코드 몇 줄로 받아올 수 있다는 점이 핵심입니다.

API 요청의 기본 구조 이해하기

API를 처음 접할 때 알아야 할 최소한의 용어는 세 가지입니다.

요청(Request): 내가 어떤 정보를 달라고 보내는 신호입니다. 보통 인터넷 주소(URL) 형태로 되어 있습니다.

응답(Response): 상대 서버가 돌려주는 결과입니다. 대부분 JSON이라는 형식으로 옵니다.

API 키(Key): 누가 요청했는지 확인하기 위한 일종의 출입증입니다. 많은 공공데이터 API나 외부 서비스는 무료로 키를 발급해줍니다.

JSON은 이름은 낯설어도 구조는 단순합니다. 중괄호와 콜론으로 이루어진 데이터 형태로, 엑셀의 표를 텍스트로 풀어놓은 것과 비슷하다고 생각하면 됩니다.

{
  "지역": "양주",
  "온도": 27.5,
  "습도": 62
}

파이썬으로 API 첫 요청 해보기

파이썬에는 requests라는 라이브러리가 있어서 API 요청을 매우 간단하게 처리할 수 있습니다. 다음은 공공 API에서 데이터를 받아와 화면에 출력하는 기본 예시입니다.

import requests

url = "https://api.example.com/weather"
params = {
    "region": "yangju",
    "key": "발급받은_API_키"
}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print("온도:", data["온도"])
    print("습도:", data["습도"])
else:
    print("요청 실패:", response.status_code)

코드를 하나씩 뜯어보면 어렵지 않습니다.

requests.get(): 상대 서버에 정보를 요청합니다.
response.status_code: 요청이 성공했는지(200이면 성공) 확인합니다.
response.json(): 응답받은 데이터를 파이썬이 다룰 수 있는 형태로 바꿔줍니다.

이렇게 받아온 데이터는 pandas와 결합해서 엑셀 파일로 저장하거나, 매일 정해진 시간에 자동 실행되도록 스케줄을 걸 수도 있습니다.

API 입문 핵심 정리

실무에 바로 적용할 수 있는 시나리오

API 학습을 시작할 때는 거창한 프로젝트보다 작은 반복 업무 하나를 목표로 잡는 것이 좋습니다. 예를 들어 다음과 같은 업무가 좋은 연습 대상입니다.

매일 아침 환율을 자동으로 받아와 엑셀 시트에 기록하기
공공데이터포털의 통계 API로 월별 자료를 자동 수집하기
특정 사이트의 공지사항 업데이트를 감지해서 메신저로 알림 보내기

이런 작업은 텍스트 정리 규칙을 함께 알아두면 더 수월해집니다. 받아온 데이터에서 필요한 값만 뽑아낼 때 정규표현식을 활용하면 코드가 훨씬 깔끔해집니다.

처음 공부할 때 주의할 점

API 이름이나 문서에 나오는 용어에 겁먹지 않는 것이 중요합니다. 대부분의 공공 API 문서에는 요청 예시 코드가 이미 제공되어 있어서, 그것을 그대로 따라 해보는 것만으로도 절반은 이해됩니다.

또한 API 키는 비밀번호처럼 취급해야 합니다. 코드 파일에 직접 적어두고 외부에 공유하는 실수를 피하고, 별도의 설정 파일로 분리해서 관리하는 습관을 처음부터 들이는 것이 좋습니다.

마지막으로 모든 API가 무료는 아니라는 점도 알아두어야 합니다. 요청 횟수 제한이 있거나 유료 플랜이 필요한 경우도 있으므로, 실무에 도입하기 전에 이용 약관과 요금 정책을 먼저 확인하는 것이 안전합니다.

학습 순서 정리

API를 처음 배우는 분들께는 다음 순서를 권합니다.

파이썬 기초 문법(변수, 반복문, 조건문) 익히기
requests 라이브러리로 공공 API 하나 호출해보기
받아온 JSON 데이터에서 필요한 값만 추출해보기
pandas로 결과를 엑셀 파일로 저장해보기
자동 실행 스케줄을 걸어 매일 반복되게 만들기

이 흐름은 처음부터 완벽하게 이해하고 넘어가기보다, 작은 성공 경험을 쌓으면서 다음 단계로 넘어가는 방식이 훨씬 효과적입니다.

마치며

API는 결국 “내 프로그램과 세상의 데이터를 연결하는 통로”입니다. 처음에는 생소한 용어들 때문에 진입 장벽이 있어 보이지만, 실제로 손으로 코드를 몇 줄 쳐보면 생각보다 단순한 구조라는 것을 금방 느끼게 됩니다. 픽셀앤코드는 양주 지역 중소기업과 공공기관을 대상으로 비전공자 눈높이에 맞춘 코딩·데이터 활용 교육을 진행하고 있으며, 실제 업무 데이터를 활용한 API 연동 실습도 함께 안내하고 있습니다.