n8n 공개 REST API
n8n v2.42요약
n8n API는 다음에서 사용할 수 있습니다. 무료 평가판에서는 사용할 수 없습니다. n8n의 공개 API1를 사용하면 GUI에서 수행할 수 있는 많은 작업을 프로그래밍 방식으로 처리할 수 있습니다. n8n은 워크플로에서 API에 접근할 수 있도록 n8n API 노드를 제공합니다.
기능 사용 가능 여부
n8n API는 다음에서 사용할 수 있습니다.
- n8n Cloud: Starter, Pro, Enterprise
- 셀프 호스팅: 모든 에디션
무료 평가판에서는 사용할 수 없습니다.
n8n의 공개 API1를 사용하면 GUI에서 수행할 수 있는 많은 작업을 프로그래밍 방식으로 처리할 수 있습니다.
n8n은 워크플로에서 API에 접근할 수 있도록 n8n API 노드를 제공합니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 섹션에서 다루는 내용#
- 인증: n8n API 요청을 인증하는 방법.
- 페이지네이션: 큰 결과 집합을 페이지 단위로 나눕니다.
- API 플레이그라운드 사용: 내장 플레이그라운드에서 API를 직접 시도해 봅니다(셀프 호스팅 n8n 전용).
- 엔드포인트 레퍼런스: OpenAPI 사양에서 생성한 전체 엔드포인트 레퍼런스.
상호작용 방식 선택#
REST API(이 섹션)#
HTTP 요청을 사용하여 n8n과 직접 상호작용합니다. 다음과 같은 경우에 적합합니다.
- 맞춤형 통합 및 애플리케이션
- 언어에 구애받지 않는 HTTP 호출
- 워크플로에서 REST API를 직접 사용
n8n CLI(개발자에게 권장)#
명령줄 환경을 원한다면 n8n CLI를 사용하세요. 공개 API를 감싸는 형태이며 다음에 최적화되어 있습니다.
- 명령줄 자동화 및 스크립팅
- CI/CD 파이프라인 통합
- AI 에이전트 통합(Claude Code, Cursor 등)
- CLI 도구를 선호하는 개발자
REST API 알아보기#
이 API 문서는 독자가 REST API에 익숙하다는 것을 전제로 합니다. 그렇지 않다면 다음 자료가 도움이 될 수 있습니다.
- KnowledgeOwl's guide to working with APIs: REST API를 호출하는 예시를 포함한 기본 소개입니다.
- IBM Cloud Learn Hub - What is an Application Programming Interface (API): API에 대한 일반적이면서도 기술적인 소개를 제공합니다.
- IBM Cloud Learn Hub - What is a REST API?: REST API에 대한 보다 상세한 정보입니다.
- MDN web docs - An overview of HTTP: REST API는 HTTP를 통해 동작하며, 수행할 작업을 지정하기 위해 HTTP 동사(메서드)를 사용합니다.
API 플레이그라운드 사용
플레이그라운드에서 API를 직접 시도해 보면 API가 어떻게 동작하는지 이해하는 데 도움이 됩니다. 실제 데이터 변경이 걱정된다면 테스트 워크플로나 테스트용 n8n 인스턴스를 설정하여 안전하게 살펴보는 것을 고려하세요.
관련 리소스#
Footnotes
-
API(애플리케이션 프로그래밍 인터페이스)는 서비스의 데이터와 기능에 대한 프로그래밍 방식의 접근을 제공합니다. API를 사용하면 소프트웨어가 외부 시스템과 더 쉽게 상호작용할 수 있습니다. API는 웹 브라우저나 UI를 통해 접근하는 전통적인 사용자 중심 인터페이스의 대안으로 제공되는 경우가 많습니다. ↩