제품 및 API 안내

Make 및 Zapier 연동

연결하기 전에

PDFgine 고객 계정, 해당 워크스페이스의 템플릿, 사용 가능한 페이지 할당량, Make 또는 Zapier 계정이 필요합니다. 먼저 템플릿을 만들고 Template Code를 확인하세요.

Make 앱은 카탈로그 심사 중입니다. Zapier 연동은 비공개입니다. 액세스하려면 PDFgine에 문의하세요. 두 연동 모두 아직 공개 카탈로그에 등록되지 않았습니다.

연동 액세스 요청

워크스페이스 연결

PDFgine 계정에서 usage:read 및 documents:render 권한이 있는 전용 API 키를 만드세요. 아래의 호스팅 API URL을 사용하세요. 미리보기에서 선택 사항인 Brand Kit 선택기를 사용할 때만 templates:read를 추가하세요.

https://api.pdfgine.com · usage:read · documents:render

커넥터의 Locale 선택기는 현재 영어와 터키어를 제공합니다. 웹사이트 언어를 바꿔도 문서 데이터나 커넥터에서 사용할 수 있는 필드는 변경되지 않습니다.

Make 시나리오 설정

  1. PDFgine에서 제공한 비공개 앱 액세스를 수락하세요. 시나리오에 PDFgine 모듈을 추가하고 API URL과 전용 API 키로 연결을 만드세요.
  2. Create a Document를 선택하고 Template Code와 Format을 설정한 다음, 이전 모듈의 값을 Template Data JSON 객체에 매핑하세요. 비동기 작업에는 Queue a Document를, 수신자용 링크에는 Create a Public Preview를 사용하세요.
  3. 샘플 데이터로 Run once를 실행하고 모듈 결과와 생성된 문서를 확인하세요. 매핑이 올바른 경우에만 예약 실행을 켜세요. Make an API call은 인증된 상대 API 경로를 지원하며 연결의 권한 범위가 계속 적용됩니다.

Zap 설정

  1. Zapier 계정에서 PDFgine 비공개 연동 초대를 수락하세요. 트리거를 선택하고 PDFgine 작업을 추가한 다음 API URL과 전용 API 키로 연결하세요.
  2. Create Document에서 Template Code와 Format을 설정하고 트리거 데이터를 유효한 JSON으로 Template Data에 매핑하세요. Queue Document와 Create Public Preview는 별도의 작업입니다. Brand Kits는 선택 사항인 드롭다운 데이터 소스이며 트리거가 아닙니다.
  3. 작업을 테스트하고 Zap을 게시한 다음 새 트리거 이벤트를 보내세요. Zap History에서 성공한 실행을 확인하고 해당 이벤트의 문서를 검토하세요. 편집기의 Test Step만으로는 실제 워크플로가 실행되었다고 볼 수 없습니다.

실제 값을 매핑하고 JSON 유효성 유지

Template Data는 템플릿 필드와 일치하는 JSON 객체여야 하며 파일 경로나 빈 자리 표시자가 아니어야 합니다. 아래 예시는 견적 템플릿용입니다. 트리거의 이름과 금액을 매핑하고, 숫자 값은 숫자로 유지하며, 전송 전에 계산된 합계를 확인하세요.

JSON 
{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

적절한 출력 선택

Create Document는 API 인증이 필요한 보호된 downloadUrl을 반환합니다. 고객이 브라우저에서 열 수 있는 링크에는 Create Public Preview를 사용하고 허용되는 액세스 기간을 선택하세요. Queue Document는 작업의 statusUrl을 반환합니다. 대기열 등록 응답은 문서가 완료되었다는 의미가 아닙니다.

대기열을 통한 생성 · 미리보기 링크

활성화하기 전에 테스트

먼저 가상의 고객 데이터를 사용하세요. 수신자, 참조 번호, 항목, 합계, 출력 형식을 확인하세요. 워크플로를 활성화한 뒤 새 이벤트를 하나 보내고 플랫폼의 실행 기록을 확인하세요. 반복적인 프로덕션 실행은 피하세요. 생성된 페이지는 PDFgine 할당량을 사용합니다.

제한 및 문제 해결

401 또는 403이면 연결과 API 권한 범위를 확인하세요. 402이면 사용 가능한 할당량을 확인하세요. 429이면 Retry-After를 따르고 요청 빈도를 줄이세요. 다시 시도하기 전에 잘못된 JSON이나 템플릿 데이터를 수정하세요. 미리보기 기간과 생성 제한은 요금제에 따라 다릅니다.

오류 · 한도 확인

연결 키를 비공개로 유지

API 키는 플랫폼의 연결 설정에만 입력하세요. Template Data, 스크린샷, 공유 실행 로그에 넣지 마세요. 연결마다 별도의 키를 사용하고 액세스가 더 이상 필요하지 않으면 PDFgine에서 폐기하세요.

문서 이벤트가 필요한가요? API 웹훅 가이드를 확인하세요. 웹훅