백엔드 & API · L0 입문 · 약 6분
API: 앱끼리 대화하는 창구
어렵게 생각하지 마. 식당에서 주문하는 거랑 똑같아
한 줄로 말하면
API는 프로그램끼리 "이렇게 부탁하면 이렇게 답해줄게"라고 정해둔 창구야.
앱이 서버에 "내 피드 보여줘"라고 할 때도, 날씨 앱이 기상청 데이터를 가져올 때도, 쇼핑몰이 카드 결제를 할 때도 전부 API로 대화해. 프로그램 세상의 공용 창구인 셈이야.
API는 세 가지 약속이야
- 어디로: 주문 창구의 주소. 예:
https://api.myapp.com/posts이런 주소 하나하나를 엔드포인트라고 해 - 어떻게 부탁할지: "글 목록 줘", "새 글 저장해줘" 같은 요청의 종류와 같이 보낼 내용
- 무엇을 받을지: 답이 어떤 모양으로 오는지. 요즘은 대부분 JSON이라는 형식이야
{
"city": "서울",
"temperature": 18,
"condition": "맑음"
}세상에는 여러 API가 있어
- 내 서버의 API: 내 앱의 글, 댓글, 회원 정보를 주고받는 창구
- 외부 서비스 API: 결제(토스페이먼츠, Stripe), 지도, 문자 발송, AI(Claude, GPT) 같은 남의 서비스를 빌려 쓰는 창구
- 기기 API: 카메라, 위치, 알림처럼 폰이나 브라우저가 앱에 열어주는 창구
외부 서비스 API는 보통 "너 누구야?"를 확인하려고 API 키라는 출입증을 요구해. 쓴 만큼 돈이 나가는 서비스가 많아서, 이 키는 반드시 서버에만 둬야 해. (보안 트랙에서 자세히!)
AI로 API를 붙일 때 조심할 것
확인 퀴즈
Q. 식당 비유에서 API에 해당하는 건?
- 손님
- 메뉴판과 웨이터
- 창고
- 식당 건물
정답 보기
2번. API는 정해진 방식으로 주문하고 정해진 모양으로 받는 창구야. 메뉴판과 웨이터가 딱 그 역할이지.
Q. AI가 짜준 외부 API 연결 코드에서
404 Not Found가 나. 먼저 의심할 건?- 내 폰이 고장 났다
- AI가 없는 엔드포인트 주소를 지어냈거나 주소가 틀렸다
- 인터넷이 너무 빠르다
- JSON이 너무 길다
정답 보기
2번. 404는 "그런 주소 없음"이야. 공식 문서와 주소를 비교해 봐.
Q. 외부 AI 서비스의 API 키는 어디에 둬야 할까?
바코친 앱에서 퀴즈 풀고 AI한테 물어보기- 앱 코드 안
- 깃허브 README
- 서버(서버리스 함수)의 비밀 저장소
- 사용자 폰의 메모장
정답 보기
3번. API 키는 서버 쪽에만 둬야 남이 꺼내 쓰지 못해.
무료 · 카카오로 바로 시작 · 레슨 243개