n8n 공개 REST API
n8n v2.29n8n API는 무료 체험 기간 동안에는 사용할 수 없습니다. n8n의 공개 API1를 사용하면 GUI에서 수행할 수 있는 많은 작업을 프로그래밍 방식으로 처리할 수 있습니다. n8n은 워크플로에서 API에 접근할 수 있도록 n8n API 노드를 제공합니다.
기능 사용 가능 여부
n8n API는 무료 체험 기간 동안에는 사용할 수 없습니다. 이 기능을 사용하려면 업그레이드하시기 바랍니다.
n8n의 공개 API1를 사용하면 GUI에서 수행할 수 있는 많은 작업을 프로그래밍 방식으로 처리할 수 있습니다. 이 섹션에서는 다음을 포함하여 n8n의 REST API를 소개합니다.
- 인증 방법
- 결과 페이지네이션
- 내장 API 플레이그라운드 사용(셀프 호스팅 n8n 전용)
- 엔드포인트 레퍼런스
n8n은 워크플로에서 API에 접근할 수 있도록 n8n API 노드를 제공합니다.
상호작용 방식 선택#
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를 통해 접근하는 전통적인 사용자 중심 인터페이스의 대안으로 제공되는 경우가 많습니다. ↩