API란 무엇인가요?

API, 즉 Application Programming Interface는 서로 다른 소프트웨어 애플리케이션이 서로 통신할 수 있도록 하는 규칙과 프로토콜의 집합입니다. 애플리케이션이 원활하게 상호 작용할 수 있도록 요청과 데이터가 어떻게 구성되어야 하는지를 지정합니다.

만능 리모컨 비유

API를 만능 리모컨처럼 생각해 보세요. 리모컨을 사용하면 기기 내부가 어떻게 작동하는지 몰라도 다양한 기기를 제어할 수 있는 것처럼, API를 사용하면 애플리케이션은 뒤에서 무슨 일이 일어나는지 몰라도 함께 작동할 수 있습니다.

이 비유에서:

리모컨은 API 인터페이스와 같습니다.
리모컨의 버튼은 API 엔드포인트와 같습니다.
버튼을 누르는 사용자는 요청을 보내는 두 번째 애플리케이션과 같습니다.
응답하는 TV나 기기는 그러한 요청을 이행하는 애플리케이션과 같습니다.

마치 TV가 신호를 어떻게 처리하는지 몰라도 채널을 바꾸기 위해 특정 버튼을 누르는 것처럼, 한 애플리케이션은 다른 애플리케이션의 내부 작동 방식을 이해하지 않고도 그 API를 사용해 데이터를 요청하거나 작업을 수행할 수 있습니다.

SaaS API의 예

많은 SaaS (Software as a Service) 애플리케이션이 API를 제공합니다. 예를 들어:

ClickUp API는 작업 생성, 작업 검색, 댓글 추가, 파일 첨부 등을 위한 수많은 엔드포인트를 제공합니다.
Gmail API를 사용하면 이메일을 보내고, 읽음으로 표시하고, 받은편지함의 다른 폴더로 이동할 수 있습니다.
Notion API를 사용하면 페이지를 업데이트하고, 데이터베이스를 만들고, 데이터베이스 항목의 정보를 검색하는 등의 작업을 할 수 있습니다.

API 엔드포인트, 입력 및 출력

API는 API 엔드포인트라고 하는 서비스 목록으로 구성됩니다. 각 엔드포인트는 특정 작업을 수행합니다. Make는 모든 API에 대한 호출을 오케스트레이션하는 솔루션으로, 어떤 유형의 프로세스든 정의할 수 있습니다. API 엔드포인트는 (수행할 작업을 이해하기 위한) 입력이 필요하고 (호출하는 애플리케이션에 결과를 전달하기 위한) 출력을 제공한다는 점을 아는 것이 중요합니다.

마치 리모컨이 올바른 버튼을 눌러야(입력) TV가 원하는 채널로 바뀔 수 있는 것처럼(출력), API도 원하는 결과를 반환하기 전에 특정 정보가 필요합니다.

API 문서 읽기: ClickUp 예시

ClickUp API 문서는 API가 Make에 왜 필수적인지에 대한 명확한 예를 보여줍니다.

ClickUp API 문서에서 다음을 찾을 수 있습니다:

사용 가능한 엔드포인트 목록: "Get Tasks", "Create Task" 등의 옵션을 포함하여 ClickUp API를 통해 사용할 수 있는 엔드포인트의 포괄적인 카탈로그입니다. (A)
"Create a Task" 엔드포인트에 대한 지침: "Create a Task" 엔드포인트를 사용하는 방법에 대한 자세한 가이드라인입니다. 필수 입력: 작업 이름, 상태 및 기타 필요한 매개변수. 예상 출력: 생성된 작업에 대한 포괄적인 정보. (B)
엔드포인트 액세스 위치: 이 특정 엔드포인트에 액세스하는 위치와 방법에 대한 정보입니다. (C)
엔드포인트 호출의 실제 예: "Create a Task" 엔드포인트를 효과적으로 호출하는 방법을 보여주는 실제 예입니다. (D)

Make가 API를 사용하는 방법

API는 애플리케이션이 정보와 서비스를 교환하도록 돕는 편리한 방법입니다. Make는 다양한 SaaS 애플리케이션의 이러한 API를 활용하여 모든 API에 대한 호출을 오케스트레이션하는 솔루션 역할을 합니다. Make는 이미 2,000개 이상의 API, 즉 2,000개의 서로 다른 애플리케이션과 통합되어 있으며, 이 숫자는 계속 증가하고 있습니다.

공식 출처：What's an API? - Help Center · 확인일：2026-09-30