n8n 공개 REST API 문서 및 가이드
n8n API는 무료 체험 기간에는 사용할 수 없습니다. n8n의 공개 API를 사용하면 GUI에서 수행할 수 있는 많은 작업을 프로그래밍 방식으로 처리할 수 있습니다. n8n은 워크플로에서 API에 접근할 수 있도록 n8n API 노드를 제공합니다.
n8n API는 무료 체험 기간에는 사용할 수 없습니다. 이 기능을 이용하려면 요금제를 업그레이드하세요.
n8n의 공개 API를 사용하면 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의 API 활용 가이드: REST API 호출 예시를 포함한 기본 입문 자료입니다.
- IBM Cloud Learn Hub - API(애플리케이션 프로그래밍 인터페이스)란 무엇인가: API에 대한 일반적이면서도 기술적인 입문 설명입니다.
- IBM Cloud Learn Hub - REST API란 무엇인가?: REST API에 대한 더 상세한 정보를 제공합니다.
- MDN web docs - HTTP 개요: REST API는 HTTP를 기반으로 동작하며, 수행할 작업을 지정하기 위해 HTTP 동사(메서드)를 사용합니다.
플레이그라운드에서 API를 직접 테스트해보면 API 동작 방식을 이해하는 데 도움이 됩니다. 실제 데이터가 변경될 것이 걱정된다면 테스트용 워크플로나 n8n 인스턴스를 별도로 구성하여 안전하게 실습해보세요.
