www.aiacademykim.co.kr
Part A 비개발자 사고법 · 07강

API는 메뉴판이다

코드는 AI가 짠다. 나는 "있는 거 가져다 붙여"라고 정확히 시키는 사장이다.

① 메뉴판으로 주문하면, 결과가 툭 나온다

메뉴 한 줄(엔드포인트)을 고르면 → 주방(남의 회사) 속은 안 봐도 결과가 나온다.

🎬 1:19 엔드포인트
📋 메뉴 한 줄 = 엔드포인트 (내가 시킬 수 있는 일 한 가지)
📋 메뉴판 = API · 🍜 메뉴 한 줄 = 엔드포인트 · 🍳 주방 = 남의 회사 서버 손님은 요리법을 몰라도 된다. 메뉴만 고르면 결과가 나온다 — API가 딱 이 자판기·메뉴판이에요.

② 주문서는 정해진 양식이 있다 (REST)

주문서 = 주소(어디 메뉴) + 동사(GET 가져다줘 / POST 새로 등록). 양식대로 보내면 짝이 맞는 응답이 돌아온다.

🎬 3:19 REST
📝 주문서 = 주소 + 동사 · 보내면(요청) 답이 온다(응답)

🧾 내가 쓰는 주문서(요청)

동사 (무엇을 할지) GET
주소 (어느 메뉴) /주문/3번테이블
➡️ ⬅️

🍽️ 주방이 보낸 답(응답)

주문을 보내면
여기로 답이 돌아와요
200 OK
주문서를 아무렇게나 써서 보내면 주방이 못 알아들어요. 양식(주소+동사)대로 써야 정확히 짝 맞는 답이 옵니다.

③ 메뉴에 없는 걸 시키면 — 에러(404)

약속된 메뉴(버튼)만 받는다. 없는 걸 주문하거나 주방에 손을 넣으려 하면 "그런 거 없어요"가 돌아온다.

🎬 비유 : 없는 버튼
🚫 404 = "그 메뉴 우리 가게엔 없어요" (틀린 게 아니라 약속 밖)

📟 주문 결과 화면

📋
메뉴를 골라 주문해 보세요
있는 메뉴는 결과가 나오고, 없는 메뉴는 에러가 떨어집니다.

핵심 : 에러는 AI나 컴퓨터가 고장 난 게 아니에요. "약속된 메뉴가 아니다"라고 정확히 알려주는 안내입니다.

④ 남의 주방을 빌려 쓴다 (오픈 API)

날씨·지도·번역·결제 — 내가 직접 안 만든다. 남이 만들어 둔 가게 메뉴를 내 앱에 가져다 붙인다.

🎬 2:22 오픈 API
🏪 오픈 API = 다른 가게 메뉴를 내 앱에 가져다 쓰기

아래 다른 가게(회사)를 누르면, 그 가게가 24시간 만들어 둔 기능이 내 앱 화면에 툭 붙습니다. 직접 만든 게 아니라 — 가져다 쓴 거예요.

🌤️
날씨 가게
+ 가져다 붙이기
🗺️
지도 가게
+ 가져다 붙이기
🌐
번역 가게
+ 가져다 붙이기
💳
결제 가게
+ 가져다 붙이기

📱 내가 만드는 앱 — 빈 칸에 남의 기능을 끼워 넣습니다

우리 동네 생활 앱
빈 칸 ① — 위에서 가게를 누르세요
빈 칸 ② — 위에서 가게를 누르세요
빈 칸 ③ — 위에서 가게를 누르세요
여러분이 쓰는 앱에 지도가 뜨죠? 그 지도, 앱 회사가 직접 만든 게 아니라 남이 만든 지도 기능을 이렇게 가져다 붙인 경우가 많아요. 세상은 이미 이렇게 굴러가고 있었습니다.

⑤ 좋은 지시 vs 나쁜 지시 (오늘의 AI 지시법)

단어를 알면 콕 집어 시키고(정방향), AI가 "API 키 필요해요" 할 때 멈추지 않고 되받아친다(역방향).

🎬 6:00 AI 지시법
정방향 내가 AI한테 시킨다 — 같은 부탁, 다른 지시, 다른 결과
✗ 나쁜 지시
결과가 여기에 나타납니다
✓ 좋은 지시
결과가 여기에 나타납니다
AI = 직원 · = 사장 사장이 직접 요리는 안 해도, "있는 메뉴 가져다 써"라고 시킬 줄은 알아야 한다.
역방향 AI가 나한테 말한다 — 모르면 멈춤, 알면 되받아치기

AI가 똑똑해질수록 '단어'로 되묻습니다. 못 알아들으면 거기서 끝. 알면 한마디로 진도를 나갑니다.

① API 키
🤖 AI 현재 날씨를 표시하려면 외부 API 키가 필요해요. 먼저 키부터 발급받으셔야 합니다.
🙄 나 (화면 보며) "어… 네…" — 뭘 해야 할지 몰라 거기서 창 닫음. 멈춤.
② 직접 만들기 vs 가져다 쓰기
🤖 AI 이 기능은 직접 만들기보다 외부 API를 호출해서 받아오는 게 낫습니다.
🙄 나 "외부 API…? 호출…?" — 무슨 말인지 몰라 그냥 "알아서 해줘"로 떠넘김.
③ 무료 한도 · 어떤 메뉴
🤖 AI 여러 날씨 API가 있는데, 어떤 엔드포인트를 쓸지와 무료 사용량 한도를 정해 주셔야 해요.
🙄 나 "엔드포인트가 뭐죠…?" — 또 막혀서 진도가 안 나감.
📋 오늘의 AI 지시법 — 복붙해서 바로 써보기
이 기능은 직접 만들지 말고, 무료 한도 있는 오픈 API를 골라서 가져다 붙여줘. 그리고 API 키는 화면에 안 새어 나가게 안전하게 숨겨서 넣어줘.

오늘 끝나고 이 한 문장을 그대로 AI에게 붙여넣어 보세요. "API 키 필요해요"에서 다시는 멈추지 않습니다.

외부강사 김지백 · AI 교육자료
← 강의 목록 🏠 홈