커뮤니티 입장하기

API (Application Programming Interface)

서로 다른 프로그램이나 서비스가 서로 소통하고 데이터를 주고받을 수 있도록 만들어진 '약속된 연결 통로'입니다.

같은 말:웹 APIApplication Programming Interface

아직 읽은 기록이 많지 않은 개념이에요
Share
목차
  1. 🤔 혹시 이런 생각 해본 적 없나요?
  2. 🔑 API, 한마디로 뭘까요?
  3. 🍽️ 레스토랑의 메뉴판과 웨이터
  4. 📦 택배 주문 시스템
  5. ⚙️ API는 어떤 종류가 있나요?
  6. 💡 이걸 알면 마케터에게 뭐가 좋을까요?
  7. 📋 3줄 요약
  8. 참고 자료

🤔 혹시 이런 생각 해본 적 없나요?

  • "GA4 데이터를 자동으로 스프레드시트로 가져올 수 없을까?"
  • "메타 광고 데이터를 우리 대시보드에서 한 번에 볼 수 없을까?"
  • "n8n이나 Zapier는 도대체 어떻게 여러 툴을 연결하는 걸까?"

이 모든 게 가능한 이유는 바로 API 덕분입니다.

🔑 API, 한마디로 뭘까요?

API(Application Programming Interface)는 서로 다른 프로그램이나 서비스가 서로 소통하고 데이터를 주고받을 수 있도록 만들어진 '약속된 연결 통로'입니다.

쉽게 말해, 여러분이 직접 프로그램 내부를 건드리지 않아도 정해진 방식으로 요청하면 원하는 기능이나 데이터를 받을 수 있게 해주는 중간 다리 역할을 합니다.

🍽️ 레스토랑의 메뉴판과 웨이터

1. 요청 (주문)
GET /menu/carbonara

"까르보나라 1개 주세요"

→
2. 서버 (주방)

메뉴 확인, 조리 후 결과를 준비합니다

→
3. 응답 (서빙)
{
  "menu": "까르보나라",
  "price": 15000,
  "status": "완료"
}

API는 정해진 형식으로 요청을 받아 주방(서버)에 전달하고, 결과를 [JSON](/class/digital-basic/what-is-json-and-data-structures)으로 돌려줍니다.

레스토랑에서 음식을 주문할 때를 생각해보세요.

  • 주방(서버): 실제 음식을 만드는 곳. 여러분은 들어갈 수 없습니다.
  • 메뉴판(API 문서): 주문 가능한 음식 목록과 방법이 적혀있습니다.
  • 웨이터(API): 여러분의 주문을 받아 주방에 전달하고, 완성된 음식을 가져다줍니다.
  • 손님(사용자): 메뉴판을 보고 웨이터에게 주문합니다.

여러분은 주방에 직접 들어가지 않아도, 웨이터에게 "까르보나라 1개 주세요"라고 정확히 요청하면 음식을 받을 수 있습니다. API도 마찬가지입니다. 정해진 방식으로 요청하면, 원하는 데이터나 기능을 받을 수 있습니다.

본문 개념을 설명하는 학습용 예시입니다. 실제 서비스 화면이 아닙니다.

📦 택배 주문 시스템

온라인 쇼핑몰에서 물건을 주문하는 과정도 API와 비슷합니다.

  • 여러분은 상품 번호와 배송지를 입력(요청)합니다.
  • 쇼핑몰 시스템은 창고에서 물건을 찾아 포장(처리)합니다.
  • 며칠 후 택배가 도착(응답)합니다.

여러분은 창고 내부를 볼 수 없지만, 정해진 양식으로 주문하면 원하는 물건을 받을 수 있습니다. API도 이렇게 요청(Request)과 응답(Response)으로 작동합니다.

⚙️ API는 어떤 종류가 있나요?

[REST API](/class/vibe-coding-basics/what-is-rest-api): 하나의 주소, 네 가지 요청 방식
https://api.example.com/users
GET
사용자 목록을 조회합니다
POST
새 사용자를 등록합니다
PUT
기존 사용자 정보를 수정합니다
DELETE
사용자를 삭제합니다

같은 엔드포인트(URL)라도 HTTP 방식에 따라 서버가 다른 작업을 수행합니다.

1. Open API (공개 API)

누구나 사용할 수 있도록 공개된 API입니다.

  • 예시: Google Maps API, OpenWeather API, 공공데이터포털

  • 대부분 무료 사용량 제한이 있고, 그 이상은 유료입니다.

2. Partner API (파트너 API) 특정 파트너사에게만 제공되는 API입니다.

  • 예시: Meta Ads API, Google Ads API (승인 필요)
  • 사용 권한을 받아야 접근 가능합니다.

3. Private API (내부 API) 회사 내부에서만 사용하는 API입니다.

  • 예시: 사내 데이터베이스 연동, 내부 툴 연결
  • 외부에서는 접근할 수 없습니다.

4. REST API (가장 흔한 방식) 웹 표준을 따르는 가장 일반적인 API 형태입니다.

  • 엔드포인트(Endpoint): API에 접근하는 URL 주소입니다.
  • 예시: https://api.example.com/users → 사용자 정보 요청
  • HTTP 방식(GET, POST, PUT, DELETE)으로 요청합니다.

💡 이걸 알면 마케터에게 뭐가 좋을까요?

1. 툴 간 자동화 연결이 가능합니다

  • Zapier, Make, n8n 같은 자동화 도구는 모두 API를 사용합니다.
  • "GA4에서 데이터 받아서 → 스프레드시트에 저장 → 슬랙 알림" 같은 워크플로우를 만들 수 있습니다.
  • 반복 작업을 자동화하여 시간을 절약할 수 있습니다.

2. 광고 데이터를 효율적으로 관리할 수 있습니다

  • Meta Ads API와 Google Ads API로 광고 성과 데이터를 자동으로 수집할 수 있습니다.
  • 여러 플랫폼의 데이터를 한 곳에 모아 통합 대시보드를 만들 수 있습니다.
  • 수동으로 다운로드하던 리포트를 자동화할 수 있습니다.

3. 개발자와 원활하게 소통할 수 있습니다

  • "API로 GA4에 이벤트를 보내주세요"라고 구체적으로 요청할 수 있습니다.
  • 어떤 데이터를 어떻게 연결해야 하는지 명확하게 전달할 수 있습니다.
  • 기술 용어를 이해하면 프로젝트 협업이 훨씬 수월해집니다.

📋 3줄 요약

  1. API는 서로 다른 프로그램이 정해진 형식으로 데이터를 주고받도록 만든 약속된 연결 통로입니다.

  2. REST API는 엔드포인트라는 URL 주소로 요청을 보내고 응답을 받는 방식이라 구글 지도와 메타 광고 같은 웹 서비스 대부분이 이 방식을 씁니다.

  3. Zapier와 Make, n8n 같은 자동화 도구는 모두 API로 움직이므로 GA4 데이터를 시트에 저장하고 슬랙으로 알리는 흐름을 코드 없이 만들 수 있습니다.

참고 자료

Share

제대로 이해했는지 한 문제로 확인해 볼까요?

답을 고르면 바로 풀이가 나와요.

마케터가 'GA4 이벤트 데이터를 자동으로 스프레드시트에 저장하고 싶다'고 할 때, 가장 적절한 방법은 무엇일까요?

11개념 / 클래스쿠키 (Cookie)