제품 및 API 안내

미리보기 링크

뷰어 및 삽입 설정

계정의 내장 뷰어 설정에서 모양, 제목 표시 여부, 페이지 이동을 설정하세요. 브랜드 표시 제거와 삽입은 요금제 권한에 따라 달라집니다. 패널에 표시되는 이용 가능 여부를 확인하세요.

허용 사이트

뷰어를 삽입할 사이트를 허용 사이트에 추가하세요. 삽입 권한과 공유 유효성은 별도로 검사합니다. 사이트를 허용해도 만료되거나 취소된 공유가 다시 활성화되지는 않습니다. 브라우저 코드나 iframe URL에 API 키를 넣지 마세요.

공유 전 확인

수신자와 같은 조건으로 링크를 테스트하세요. 페이지 수, 차트와 표의 레이아웃, 다운로드 가능한 형식, 만료 시간을 확인합니다. 허용되지 않은 사이트의 삽입도 테스트하세요. 계정 미리 보기가 작동하는 것만으로는 외부 접근이 활성화되었다고 볼 수 없습니다.

고객이 계정 없이 열 수 있는 만료형 열람 링크를 만듭니다. 한 번의 호출로 PDF와 DOCX 다운로드 링크를 모두 받을 수 있습니다.

요청 
curl -X POST https://api.pdfgine.com/api/v1/preview \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateCode": "invoice", "formats": ["pdf", "docx"], "data": { } }'
응답 
{
  "previewId": "prv_481fac83d9f14a4493021eb128d0876b",
  "previewUrl": "/p/prv_481fac83d9f14a4493021eb128d0876b",
  "expiresAt": "2026-08-29T13:23:43+00:00",
  "pageCount": 1,
  "downloads": [
    { "format": "pdf", "downloadUrl": "/api/v1/previews/prv_481f.../download/pdf?expires=...&token=..." },
    { "format": "docx", "downloadUrl": "/api/v1/previews/prv_481f.../download/docx?expires=...&token=..." }
  ]
}

링크에는 추측할 수 없는 서명이 포함되며 expiresAt에 종료됩니다.

문서를 사용할 수 있는 기간

PDFgine은 문서를 생성하고 전달하며, 생성한 문서를 보관할지는 사용자가 선택합니다. 제품은 자체 입력(템플릿, 브랜드 자산)과 임시 출력만 보관합니다. 각 출력은 요청에서 선택한 기간 동안 유지됩니다. accessProfile: short는 24시간(기본값), standard는 7일, extended는 30일(7일과 30일은 Go 이상), quarter는 90일(Max)입니다. 그 기간 동안 공유 링크를 열 수 있으며, 실제 생성 문서(/render, /documents/render)는 API로 다시 다운로드할 수 있습니다. 기간이 끝나면 다운로드 요청은 410을 반환하고 출력은 24시간 이내에 삭제됩니다. 생성 기록, 페이지 수, 사용량 데이터는 남습니다. 영구 보관하려면 생성 직후 자신의 시스템에 저장하세요.

90일 링크

standard 및 extended 프로필 외에 링크를 90일간 유지하는 quarter 프로필이 있습니다. 상대방이 분기 내내 다시 열 수 있어야 하는 계약에 사용할 수 있습니다. 최상위 요금제에서 제공되며 각 요금제에서 사용할 수 있는 프로필은 해당 요금제 권한에 표시됩니다.

링크 조기 종료

공유 링크는 보통 expiresAt에 종료됩니다. 더 이상 문서를 보여 주지 않으려면 취소하세요. 응답은 204이며 링크는 즉시 작동을 멈춥니다.

cURL 
curl -i -X POST https://api.pdfgine.com/api/v1/previews/prv_481fac83d9f14a4493021eb128d0876b/revoke \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

HTTP/1.1 204 No Content

자주 발생하는 문제

  • 미리보기 생성은 200이 아닌 201, 취소는 본문 없는 204를 반환합니다. 모든 응답을 JSON으로 파싱하는 클라이언트는 취소 시 실패합니다.
  • accessProfile이 링크 유효 기간을 정하며 더 긴 프로필에는 해당 요금제가 필요합니다. quarter가 포함되지 않은 요금제에서 요청하면 조용히 기간을 줄이지 않고 거부합니다.
  • downloads 안의 다운로드 링크에는 서명과 만료 시각이 포함됩니다. 주소 대신 previewId를 저장하세요. 저장한 주소는 만료되면 작동하지 않습니다.
  • 취소는 링크를 닫는 것이며 문서를 삭제하지 않습니다. 파일은 계속 내 소유이며 보관 기간이 끝날 때까지 API로 다운로드할 수 있습니다.
  • 미리보기는 실제 생성 한도가 아닌 미리보기 페이지를 사용합니다. 같은 문서를 /render로 다시 생성하면 별도의 청구 대상 페이지로 집계됩니다.