API란? 비개발자도 이해하는 API 뜻과 일상 속 예시

결론부터

API는 프로그램끼리 대화하는 창구입니다

API(에이피아이)란 프로그램과 프로그램 사이의 대화 창구입니다.

AI 관련 글이나 뉴스를 보면 "OpenAI API를 활용해서...", "API 호출 비용이..." 같은 표현이 계속 등장합니다. 개발자들은 밥 먹듯이 쓰는 단어인데, 비개발자 입장에서는 정확히 뭔지 감이 잡히지 않습니다.

결론부터 말씀드리면, API 뜻은 단순합니다. 한 프로그램이 다른 프로그램에게 "이거 좀 해줘"라고 부탁하고, 결과를 받아오는 통로입니다. 이 글을 읽고 나면 "API가 그거구나" 하고 바로 이해할 수 있습니다.

이미 매일 쓰고 있습니다

스마트폰만 쓰면 하루에도 수십 번 API를 사용합니다

API 뜻을 알고 나면 일상이 다르게 보입니다. 우리가 이미 매일 API를 사용하고 있기 때문입니다.

카카오 로그인. 쇼핑몰에서 "카카오로 로그인" 버튼을 누르면, 쇼핑몰이 카카오 서버에 "이 사람 누구야?"라고 API로 물어봅니다. 카카오가 "김철수 씨입니다"라고 답하면, 쇼핑몰은 그 정보로 로그인을 처리합니다.

날씨 앱. 날씨 앱을 열면 기상청 API에 "서울 오늘 날씨 알려줘"라고 요청합니다. 기상청이 기온과 강수확률을 보내주면, 앱이 그 데이터를 화면에 예쁘게 보여줍니다.

배달 앱 결제. 배달 앱에서 결제 버튼을 누르면, 앱이 카드사 API에 "19,800원 결제해줘"라고 보냅니다. 카드사가 "승인 완료"라고 답하면 주문이 끝납니다.

전부 같은 구조입니다. 한 프로그램이 다른 프로그램에게 창구를 통해 부탁하고, 결과를 받아오는 것. 이게 API 예시의 전부입니다.

요청, 응답, 열쇠

API를 이루는 세 가지 핵심

API는 세 가지로 이루어져 있습니다.

요청. "이거 해줘"라는 부탁입니다. 날씨 앱이 기상청에 "서울 오늘 날씨 알려줘"라고 보내는 게 요청입니다.

응답. "여기 있어"라는 결과입니다. 기상청이 "맑음, 22도"라고 돌려주는 게 응답입니다.

API 키. 출입증 같은 것입니다. 아무나 API를 사용하면 안 되니까, 허가된 사람에게만 발급하는 고유 번호입니다.

정리하면 이렇습니다. 누가, 어떤 열쇠(API 키)로, 무엇을 요청하면, 결과(응답)가 돌아온다. API의 작동 원리는 이게 전부입니다.

AI와 API

ChatGPT를 내 업무 도구에 연결하려면 API가 필요합니다

ChatGPT를 웹사이트에서 직접 쓸 때는 API를 몰라도 됩니다. 그냥 채팅창에 입력하면 되니까요.

그런데 AI를 내 업무 도구에 연결하고 싶다면 이야기가 달라집니다.

노션에 있는 회의록을 AI에게 요약시키고 싶다고 해보겠습니다. 말로는 한 문장이지만, 실제로는 세 가지 관문을 모두 통과해야 합니다.

첫 번째 관문은 API 키 발급입니다. 앞에서 API 키를 식당의 회원카드라고 했습니다. 문제는 이 회원카드가 서비스마다 따로 발급된다는 점입니다. 노션 회원카드로는 노션에만 들어갈 수 있고, ChatGPT에 들어가려면 ChatGPT를 만든 회사(OpenAI)에서 또 다른 회원카드를 받아야 합니다. 두 회원카드를 받으려면 각 서비스의 개발자 페이지에 가입하고, 신청서를 쓰고, 나중에 쓴 만큼 요금이 청구되도록 신용카드 정보까지 등록해야 합니다.

두 번째 관문은 데이터 형식입니다. 회원카드를 들고 노션에 들어가서 회의록을 꺼내면, 노션은 회의록을 사람이 바로 못 읽는 형태로 건네줍니다. 마치 창고에서 막 꺼낸 어지러운 상자 같아서, 그 안에는 회의록 내용 말고도 문서 ID, 작성 시각, 블록 구조 같은 부가 정보가 잔뜩 섞여 있습니다. ChatGPT에게 이 상자를 그대로 건네면 뭐가 뭔지 이해하지 못합니다. 그래서 회의록의 진짜 내용만 깔끔한 문장으로 추려서 ChatGPT가 이해할 수 있는 형태로 다시 포장해야 합니다.

세 번째 관문은 연결 코드입니다. 노션 API와 ChatGPT API는 서로의 존재를 알지 못합니다. 둘 사이를 오가며 데이터를 받아 넘기고, 형식을 맞춰주고, 결과를 다시 가져오는 중개인 역할이 필요한데, 이 중개인이 바로 코드입니다. 그리고 이 중개 코드를 써야 하는 사람은 바로 사용자입니다. 노션도 ChatGPT도 "너네 둘이 좀 대화해봐" 하고 알아서 연결해주지 않기 때문에, 두 API를 엮는 일은 전적으로 연결하려는 사람의 몫입니다.

여기까지 오면 배워야 할 것이 쌓여 있습니다. API 키 두 개 발급, 데이터 형식 정리, 연결 코드 작성, 에러가 날 때마다 원인 찾기, 매달 청구되는 사용료 관리까지. 이미 개발자라면 한두 시간이면 끝날 일이지만, 비개발자에게는 실질적으로 넘기 어려운 관문입니다.

그래서 등장한 게 MCP입니다. API를 사람이 직접 연결하는 대신, AI가 알아서 필요한 API를 찾아 연결해주는 새로운 방식입니다.

MCP가 궁금하시다면 MCP가 뭔가요?에서 이어서 읽으실 수 있습니다.

정리

API 뜻을 한 장으로 정리합니다

API란 프로그램과 프로그램 사이의 대화 창구입니다. 한 프로그램이 다른 프로그램에게 필요한 데이터를 부탁하고, 결과를 받아오는 방식으로 동작합니다.

개념	의미
API	프로그램 간 대화 통로
요청	데이터를 달라는 부탁
응답	돌려받는 결과 데이터
API 키	사용 권한을 증명하는 열쇠
API 문서	어떤 요청이 가능한지 적힌 목록

앞으로 AI 관련 글에서 "API"라는 단어가 나오면, "프로그램끼리 데이터를 주고받는 통로" 라고 이해하시면 됩니다. API 종류에는 REST API, WebSocket 등 여러 가지가 있지만, 핵심 원리는 전부 같습니다.