Adobe API를 활용한 PDF 자동 처리 및 추출 - n8n 워크플로우

문서 엔지니어: 일괄 PDF 처리, 분할 또는 데이터 추출 자동화가 필요한 전문가. 개발자 및 통합 담당자: Adobe PDF Services와 같이 복잡한 타사 API와 연동할 안정적인 n8n 템플릿을 찾는 사용자. 자동화 전문가: 비동기 폴링 로직을 포함하는 안정적인 프로덕션급 n8n 파일 처리 워크플로우가 필요한 담당자. 데이터 분석가: n8n 노드를 사용하여 대량의 PDF에서 구조화된 데이터(표, 텍스트)를 자동으로 추출해야 하는 개인.

강력한 API와 통합하려면 토큰 생성, 파일 에셋 생성, 바이너리 업로드 및 비동기 상태 폴링과 같은 복잡한 단계를 처리해야 하는 경우가 많습니다. 이 특정 n8n 워크플로우는 Adobe PDF Services API를 완벽하게 감싸는(wrapper) 역할을 하여 이러한 문제를 해결합니다. 문서를 분할하든, 압축하든, 고급 콘텐츠를 추출하든 원활한 PDF 처리 경험을 보장합니다. 이 재사용 가능한 n8n 워크플로우 아키텍처는 더 큰 자동화 파이프라인에 쉽게 통합될 수 있어 PDF 처리와 같은 중요한 단계에 대한 맞춤형 스크립팅이 필요 없습니다.

이 강력한 n8n 워크플로우는 Adobe 서비스로 PDF 조작 작업의 전체 수명 주기를 관리하도록 설계되었습니다. 프로세스는 테스트를 위한 Manual Trigger(수동 트리거)가 Dropbox n8n 노드 및 작업(예: extractpdf)을 정의하는 Set n8n 노드에 연결되거나, 서브 워크플로우로 호출될 경우 Execute Workflow Trigger n8n 노드를 통해 시작됩니다.

1. 인증: n8n 워크플로우는 먼저 사용자 지정 자격 증명을 사용하여 Adobe API로부터 단기적인 베어러 access_token을 얻기 위해 HTTP Request n8n 노드를 실행합니다.


2. 에셋 생성: 토큰을 사용하여 /assets 엔드포인트로 호출하여 업로드 슬롯을 확보하고 uploadUri를 가져옵니다.


3. 파일 업로드: 지정된 uploadUri로 PUT 요청을 통해 실제 PDF 바이너리 데이터를 업로드합니다.


4. 프로세스 시작: 후속 HTTP Request n8n 노드가 assetID와 정의된 페이로드를 사용하여 요청된 작업(예: extractpdf)을 시작합니다. 이 단계에서 작업 상태 확인을 위한 location 헤더가 반환됩니다.


5. 비동기 폴링: Adobe 처리는 비동기식이므로 n8n 워크플로우는 폴링 루프에 진입합니다. Wait n8n 노드(5초)와 HTTP Request n8n 노드를 사용하여 작업 위치 URL로 상태를 확인합니다. Switch n8n 노드가 흐름을 라우팅합니다. 상태가 '진행 중(in progress)'이면 대기 단계로 다시 루프됩니다. 처리가 완료되거나 실패하면 흐름이 계속됩니다.


6. 결과 전달: 마지막으로, 결과(다운로드 링크 또는 처리된 데이터)는 Set n8n 노드를 사용하여 수집된 후 호출한 n8n 워크플로우로 전달되거나 최종 출력으로 표시됩니다.

이 n8n 워크플로우는 성공적인 Adobe API 상호 작용을 위해 특정 자격 증명이 필요합니다.

1. 가져오기: 제공된 JSON 데이터를 복사하여 n8n 인스턴스의 'New' 메뉴 > 'Import from JSON'을 통해 붙여넣습니다.


2. Adobe API 토큰 자격 증명: Authenticartion (get token) n8n 노드의 경우 'Custom Auth' 자격 증명을 생성합니다. 동봉된 메모에 표시된 대로 헤더(Content-Type: application/x-www-form-urlencoded)와 본문(clientid 및 clientsecret 포함)을 구성합니다.


3. Adobe API 호출 자격 증명: 다른 모든 API 요청(예: Create Asset 및 결과 다운로드)의 경우 'HTTP Header Auth' 자격 증명을 생성합니다. client_id를 값으로 사용하여 X-API-Key 헤더를 전송하도록 구성합니다. 이렇게 하면 이 n8n 템플릿의 모든 API 호출이 올바르게 승인됩니다.


4. 테스트 설정: 수동 경로를 사용하여 n8n 워크플로우를 테스트하는 경우, 필요한 PDF 입력을 제공하기 위해 Load a test pdf file 노드에 유효한 Dropbox 자격 증명과 파일 경로를 구성해야 합니다.

이 n8n 워크플로우는 복잡한 Adobe API 상호 작용을 실행하기 위해 몇 가지 중요한 노드를 활용합니다.

Manual Trigger / Execute Workflow Trigger: n8n 워크플로우의 시작점입니다. Execute Workflow Trigger를 사용하면 이 핵심 로직을 더 큰 자동화 구조 내의 모듈식 구성 요소(서브 워크플로우)로 활용할 수 있습니다.
Set (Adobe API Query): Adobe의 특정 작업(예: endpoint: extractpdf) 및 Adobe API에서 요구하는 필요한 JSON 페이로드 매개변수를 구성합니다.
HTTP Request (Authenticartion): POST 요청을 Adobe /token 엔드포인트로 보내 베어러 토큰을 획득합니다. 이 토큰은 이 n8n 워크플로우의 후속 보안에 필수적입니다.
HTTP Request (Create Asset): 보류 중인 파일을 Adobe에 등록하고 바이너리 데이터가 전송될 uploadUri를 요청합니다. 검색된 액세스 토큰을 Authorization 헤더에 사용합니다.
HTTP Request (Upload PDF File (asset)): PUT 메서드를 사용하여 Adobe가 제공한 uploadUri로 PDF 바이너리 데이터를 보내는 중요한 단계입니다. 이 단계는 이 n8n 노드로 전달되는 바이너리 데이터에 의존합니다.
HTTP Request (Process Query): 최종 요청을 보내 PDF 변환(예: 분할, 추출)을 시작합니다. 여기에는 assetID와 작업 페이로드가 포함됩니다. 이 요청은 상태 확인 위치를 반환합니다.
Wait 5 second: 폴링 루프에 지연 시간을 도입하여 비동기 Adobe 프로세스가 완료되기를 기다리는 동안 과도한 API 호출을 방지합니다. 이는 필수적인 제어 흐름 n8n 노드입니다.
Switch: 폴링 루프 로직을 관리합니다. 작업 상태를 확인합니다. '진행 중(in progress)'이면 실행을 Wait 5 second n8n 노드로 다시 라우팅하여 상태 확인을 반복하게 하므로 강력한 n8n 워크플로우가 됩니다.