May 10, 2026

비개발자 기획자가 직접 경험한 API, 쉽게 이해하고 써먹는 법

안녕하세요, 얼렁뚱땅 기획자입니다.

요즘 IT 공부를 하다 보면 API라는 말을 정말 자주 듣습니다. 처음엔 전문가들이 쓰는 용어 같아 멀게만 느껴졌는데, 직접 조금씩 써 보니 생각보다 **“데이터를 주고받는 약속”**에 가깝다는 걸 알게 됐어요.

이 글에서는 개발자가 아닌 기획자 눈높이에서 API를 어떻게 이해하면 좋은지, 그리고 무료 공공 API로 한 번 받아 보는 흐름까지 정리해 보겠습니다.

API란 무엇인가요? (기획자 눈높이)

한 줄로 말하면, 서비스끼리 정보를 주고받을 수 있게 해 주는 연결 통로라고 보면 됩니다.

앱 A가 “이 데이터 줘”라고 요청하면
서버가 정해진 형식으로 응답하고
그걸 앱 A가 화면이나 기능에 반영합니다

왜 기획자가 알아두면 좋을까요?

기획 단계에서 “어떤 데이터가 필요한지”, “그걸 어디서 가져올 수 있는지”, **“우리가 직접 만들지 않고 붙일 수 있는지”**를 말할 수 있으면, 개발·디자인과 대화가 훨씬 수월해집니다.

예를 들어 지도·날씨·대기오염 같은 데이터는 직접 수집·가공하기 어렵죠. 이때 공개 API를 쓰면 “처음부터 다시 만들기”보다 빠르게 검증할 수 있습니다.

실습: 공공 데이터 API로 데이터 받아보기

말로만 들으면 감이 안 오니, 손으로 한 번 해 보는 걸 추천합니다. 저는 공공 데이터 포털·지자체 오픈 API 쪽을 먼저 봤어요. (서비스마다 가입·키 발급 절차가 조금씩 다릅니다.)

대략적인 순서

포털 또는 해당 기관 사이트에서 회원 가입
원하는 데이터/API 신청 후 인증키(API Key) 발급
문서에 나온 요청 URL과 파라미터를 맞춰 호출
응답이 JSON 등으로 오면, 구조를 보며 “어떤 필드가 있는지” 확인

URL 예시 (인증키는 반드시 본인 것으로 교체)

문서에 나온 형식에 맞춰 주소를 만들면 됩니다. 실제 키는 외부에 노출하지 말고, 예시에는 플레이스홀더만 두는 편이 안전합니다.

http://openapi.seoul.go.kr:8088/{발급받은_인증키}/json/RealtimeCityAir/1/5/

브라우저 주소창에 넣어 보거나, 개발자 도구(F12) → 네트워크 탭으로 응답을 보면서 필드 이름·값 형태를 익히면 좋습니다.

JSON이 낯설다면

처음엔 { "키": "값" } 구조만 이해해도 충분합니다.

중괄호 안에 항목들이 모여 있고
목록이면 대괄호 [] 안에 여러 개가 들어가는 식입니다

화면에 예쁘게 보여 주려면 개발이 필요하지만, **“어떤 데이터가 오는지”**만 파악해도 기획·검증에는 큰 도움이 됩니다.

API와 친해지는 팁

문서를 정복하려 하기보다, 한 번 통신해 보기

API마다 GET/POST, 헤더, 쿼리 파라미터 규칙이 달라서 초반엔 헷갈리기 쉽습니다. 그럴 땐 공식 문서의 “호출 예시” 한 블록만 따라 해 보는 게 빠릅니다.

오류가 나면 그게 학습 포인트

인증키 오타·만료
호출 제한(일일 한도 등)
필수 파라미터 누락

같은 실수를 한 번씩 겪고 나면, 다음 API는 훨씬 빨리 익숙해집니다.

Postman 같은 도구도 도움이 됩니다

브라우저만으로 어렵다면 Postman처럼 요청을 저장하고 반복해 볼 수 있는 도구를 써 보세요. “요청 → 응답” 흐름을 눈으로 확인하기 좋습니다.

기획자 입장에서의 활용 아이디어

API를 한 번 붙여 보면, 기획 아이디어가 데이터 단위로 구체화되는 느낌이 납니다.

지역별 대기질·날씨를 보여 주는 정보 페이지
사내 알림에 날씨·공휴일 API를 묶어 “오늘 준비물” 안내
오픈 데이터로 프로토타입만 먼저 만들고, 반응을 본 뒤 자체 수집 여부 결정

중요한 건 “코드를 얼마나 짜느냐”보다 어떤 데이터를 어디서 가져와 어떤 가치로 연결할지를 그릴 수 있느냐입니다. 그 위에 개발 리소스가 얹히면 속도가 나요.

내가 실천한 API 공부법

작은 API 하나만 골라 끝까지 호출해 보기 (성공 응답을 한 번이라도 받기)
실패하면 에러 메시지·문서를 같이 보며 원인 적어 두기
Postman 등으로 같은 요청을 저장해 두고 반복
배울 때마다 “우리 서비스라면 어디에 쓸까?” 한 줄씩 메모하기

마무리

API는 듣기엔 멀어 보여도, 요청 한 번 성공해 보는 경험이 있으면 감이 확 달라집니다. 복잡한 코딩 없이도 공개 API로 데이터의 모양과 가능성을 확인할 수 있다는 점이, 기획자 입장에선 큰 수확이었어요.

이제는 “API가 뭔지 모르겠다”보다 **“이 데이터, 어떤 API로 가져올 수 있지?”**부터 떠올릴 수 있게 됐습니다. 관심 가는 주제의 오픈 API 하나 골라, 같은 순서로 한 번 따라 해 보시길 바랍니다.

다음 글에서 또 만나요.
얼렁뚱땅 기획자였습니다.