제품 및 API 안내

마켓플레이스 템플릿

완성된 디자인이 제공하는 것

마켓플레이스는 제안서, 보고서, 프레젠테이션 등 문서의 출발점으로 쓸 수 있는 PDFgine 디자인을 제공합니다. 워크스페이스에 추가한 후 생성기에서 텍스트, 데이터, 색상, 레이아웃을 편집할 수 있습니다.

현재 마켓플레이스에는 PDFgine만 템플릿을 게시합니다. 고객이 직접 만든 템플릿을 판매하는 게시자 기능은 없습니다.

이용 방식

무료: 필요한 권한이 있는 사용자는 템플릿을 워크스페이스에 바로 추가할 수 있습니다.
요금제에 포함: 이용 중인 구독 요금제에 템플릿이 포함되어 있으면 추가 요금이 없습니다.
유료: 일회성 결제가 확인되면 해당 워크스페이스에 템플릿을 설치할 수 있습니다.

템플릿 가져오기 및 사용

카테고리나 검색으로 디자인을 찾은 후 표지와 설명을 살펴보세요.
무료 또는 요금제에 포함된 템플릿을 추가하거나, 유료 디자인의 안전한 결제를 완료하세요.
설치하면 선택한 워크스페이스의 템플릿 영역에 편집 가능한 디자인 사본이 추가됩니다.
생성기에서 열어 샘플 데이터를 내 데이터로 바꾸고, 게시 전에 PDF, Word, Viewer 출력을 확인하세요.

템플릿 코드는 워크스페이스 안에서 고유해야 합니다. 중복되어도 기존 템플릿을 덮어쓰지 않으며 다른 코드를 선택하도록 안내합니다.

API를 통한 게시 및 설치

마켓플레이스 화면의 모든 작업을 엔드포인트로 수행할 수 있습니다. 게시된 항목 조회, 내 계정으로 템플릿 복사, 내 템플릿 게시 및 가격 설정이 가능합니다.

cURL

# 게시된 항목 목록 조회
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# 하나를 내 계정으로 복사
curl -X POST https://api.pdfgine.com/api/v1/marketplace/templates/consulting-proposal/install \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "proposal", "name": "제안서" }'

# 내 템플릿 게시
curl -X POST https://api.pdfgine.com/api/v1/templates/invoice/marketplace \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "결제 조건이 포함된 청구서",
        "summary": "결제 조건과 합계 블록이 포함된 청구 템플릿입니다.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# 가격 설정 - isFree가 false이면 priceMinorUnits가 필수
curl -X PUT https://api.pdfgine.com/api/v1/marketplace/templates/invoice-with-payment-terms/offer \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "isFree": false,
        "priceMinorUnits": 4900,
        "currency": "USD",
        "includedPlanCodes": ["business", "enterprise"],
        "expectedVersion": 3
      }'

설치하면 템플릿이 내 계정으로 복사됩니다. 이후 게시자가 수정해도 내 사본에는 반영되지 않습니다. 게시할 때 템플릿에 포함된 글꼴과 이미지를 재배포할 권한이 있는지 확인해야 하며 이 확인 내용은 기록됩니다.

직접 만드는 차트와 템플릿

직접 템플릿이나 차트를 만드는 데는 마켓플레이스 구매가 필요하지 않습니다. 판매 대상은 PDFgine이 준비한 완성된 디자인입니다.

마켓플레이스 열기 →

자주 발생하는 문제

설치하면 디자인이 워크스페이스로 복사됩니다. 이후 게시자의 변경은 사본에 반영되지 않으며 내 수정 사항도 덮어쓰지 않습니다.
코드는 워크스페이스에서 사용 중이지 않아야 합니다. 충돌해도 템플릿을 덮어쓰지 않으며 설치를 거부하고 다른 코드를 요청합니다.
현재는 PDFgine만 게시할 수 있습니다. publisher 역할이 없는 워크스페이스에서는 게시 및 판매 조건 엔드포인트가 403을 반환하므로 아직 이를 기반으로 판매자 흐름을 만들지 마세요.
목록 커서는 필터를 포함합니다. before를 유지한 채 검색, 카테고리, locale을 바꾸면 의도적으로 400을 반환합니다. 그렇지 않으면 같은 커서가 다른 목록을 가리키기 때문입니다.
유료 디자인은 결제가 확인된 후에만 설치됩니다. 설치를 먼저 호출하고 나중에 결제하면 대기열에 들어가는 것이 아니라 거부됩니다.