API 인증

n8n 공개 REST API의 인증 방법과 API 키 생성, 사용, 삭제 및 스코프 설정을 설명합니다.

n8n은 API 키를 사용하여 API 호출을 인증합니다. 기능 가용성 n8n API는 무료 체험 기간 중에는 사용할 수 없습니다. 이 기능을 이용하려면 플랜을 업그레이드하세요. API 키 생성 # n8n에 로그인합니다. Settings > n8n API 로 이동합니다. Create an API key 를 선택합니다. Label 을 선택하고 키의 Expiration 시간을 설정합니다. 엔터프라이즈 플랜을 사용 중이라면 키에 부여할 Scopes 를 선택합니다. 사용 가능한 전체 스코프 목록은 API 스코프 를 참조하세요. My API Key 를 복사하여 API 호출 인증에 사용합니다. 키를 사용한 API 호출 # X-N8N-API-KEY 라는 헤더에 API 키를 담아 API 호출 시 전송합니다. 예를 들어, 활성화된 모든 워크플로를 가져오려는 경우 curl 요청은 다음과 같습니다: # For a self-hosted n8n instance curl -X 'GET' \ '<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v<version-number>/workflows?active=true' \ -H 'accept: application/json' \ -H 'X-N8N-API-KEY: <your-api-key>' # For n8n Cloud curl -X 'GET' \ '<your-cloud-instance>/api/v<version-number>/workflows?active=true' \ -H 'accept: application/json' \ -H 'X-N8N-API-KEY: <your-api-key>' 노드 설정 # 워크플로 내에서 n8n API를 호출하려면 n8n node 를 사용합니다. 자격 증명을 생성할 때 다음 필드를 입력합니다: API Key : API 키 생성 에서 생성한 키를 붙여넣습니다. Base URL : 다음 형식 중 하나로 인스턴스의 API 루트를 입력합니다: Cloud: https://<name>.app.n8n.cloud/api/v1 ( <name> 은 Cloud 서브도메인) Self-hosted: https://<your-instance-url>/api/v1 사용 가능한 작업 및 파라미터는 n8n node 문서를 참조하세요. API 키 삭제 # n8n에 로그인합니다. Settings > n8n API 로 이동합니다. 삭제할 키 옆의 Delete 를 선택합니다. Delete Forever 를 선택하여 삭제를 확인합니다. API 스코프 # 엔터프라이즈 인스턴스 사용자는 스코프를 통해 API 키가 접근할 수 있는 리소스와 작업을 제한할 수 있습니다. 키의 용도에 맞는 최소한의 스코프를 선택하세요. 엔터프라이즈가 아닌 API 키는 계정의 모든 리소스 및 기능에 대한 전체 접근 권한을 가집니다. API 키 스코프와 프로젝트 역할 스코프 API 키 스코프는 인스턴스 수준에서 API 키가 수행할 수 있는 작업을