API 인증

n8n의 퍼블릭 REST API에 대한 인증을 설명합니다.

n8n은 API 호출을 인증하기 위해 API 키를 사용합니다. Note 기능 사용 가능 여부 n8n API는 무료 체험 기간 동안에는 사용할 수 없습니다. 이 기능을 이용하려면 업그레이드해 주세요. API 키 생성 # n8n에 로그인합니다. Settings > n8n API 로 이동합니다. Create an API key 를 선택합니다. Label 을 선택하고 키의 Expiration (만료) 시간을 설정합니다. Enterprise 플랜을 사용 중이라면 키에 부여할 Scopes (범위)를 선택합니다. 사용 가능한 전체 범위 목록은 API Scopes 를 참고하세요. My API Key 를 복사하여 이 키로 호출을 인증하는 데 사용합니다. 키를 사용해 API 호출하기 # API 호출 시 X-N8N-API-KEY 라는 이름의 헤더에 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 : Create an API key 에서 생성한 키를 붙여넣습니다. 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 범위 # enterprise instances 를 사용하는 사용자는 범위를 지정하여 API 키가 접근할 수 있는 리소스와 작업을 제한할 수 있습니다. 키의 용도에 맞게 필요한 최소한의 범위를 선택하세요. Non-enterprise API 키는 계정의 모든 리