외부 훅

n8n이 특정 작업을 실행할 때마다 커스텀 코드를 실행하려면 외부 훅을 사용하세요.

외부 훅을 사용하면 n8n이 특정 작업을 수행할 때마다 커스텀 코드를 실행할 수 있습니다. 데이터 로깅, 데이터 변경, 또는 오류 발생 시 작업 금지에 사용하세요. 두 가지 유형이 있습니다: 백엔드 훅 : 서버 측에서 실행되며, EXTERNAL_HOOK_FILES 환경 변수를 사용하여 등록합니다. 프론트엔드 훅 : 브라우저에서 실행되며, script 태그로 로드됩니다. 훅 등록에 사용되는 환경 변수에 대해서는 외부 훅 환경 변수 를 참조하세요. 백엔드 훅 # 사용 가능한 훅 # 훅 인수 설명 credentials.create [credentialData: ICredentialsDb] 새 자격증명이 생성되기 전에 호출됩니다. 자격증명 수를 제한하는 데 사용합니다. credentials.delete [id: credentialId] 자격증명이 삭제되기 전에 호출됩니다. credentials.update [credentialData: ICredentialsDb] n8n이 기존 자격증명을 저장하기 전에 호출됩니다. frontend.settings [frontendSettings: IN8nUISettings] n8n 시작 시 호출됩니다. 예를 들어 표시되는 OAuth URL과 같은 프론트엔드 데이터를 덮어쓰는 데 사용할 수 있습니다. n8n.ready [app: App] n8n이 준비되면 호출됩니다. 예를 들어 커스텀 API 엔드포인트를 등록하는 데 사용합니다. n8n.stop n8n 프로세스가 중지될 때 호출됩니다. 일부 프로세스 데이터를 저장할 수 있습니다. oauth1.authenticate [oAuthOptions: clientOAuth1.Options, oauthRequestData: {oauth_callback: string}] OAuth1 인증 전에 호출됩니다. OAuth 콜백 URL을 덮어쓰는 데 사용합니다. oauth2.callback [oAuth2Parameters: {clientId: string, clientSecret: string | undefined, accessTokenUri: string, authorizationUri: string, redirectUri: string, scopes: string[]}] OAuth2 콜백에서 호출됩니다. OAuth 콜백 URL을 덮어쓰는 데 사용합니다. workflow.activate [workflowData: IWorkflowDb] 워크플로가 활성화되기 전에 호출됩니다. 활성 워크플로 수를 제한하는 데 사용합니다. workflow.afterCreate [workflowId: string] 워크플로가 생성된 후에 호출됩니다. workflow.afterDelete [workflowId: string] 워크플로가 삭제된 후에 호출됩니다. workflow.afterUpdate [workflowData: IWorkflowBase] 기존 워크플로가 저장된 후에 호출됩니다. workflow.create [workflowData: IWorkflowBase] 워크플로가 생성되기 전에 호출됩니다.