서명 요청 / 서식(템플릿)

서식(템플릿)

같은 문서를 사람만 바꿔 반복해 보낼 때 씁니다. PDF 와 입력란 배치, 서명자 역할을 한 번 저장해 두고, 이후에는 서명자만 넘깁니다.

GET/templates

GET/templates/:id

GET/templates/:id/file

POST/templates

DELETE/templates/:id

만들기

titlestring필수

서식 이름

fileBase64string필수

PDF base64. 페이지 수는 서버가 셉니다

rolesobject[]필수

서명자 역할. `[{ "name": "근로자" }]`

fieldsobject[]옵션

입력란. `participantIndex` 대신 `roleIndex` 를 씁니다

파라미터타입필수설명

titlestring필수서식 이름

fileBase64string필수PDF base64. 페이지 수는 서버가 셉니다

rolesobject[]필수서명자 역할. [{ "name": "근로자" }]

fieldsobject[]옵션입력란. participantIndex 대신 roleIndex 를 씁니다

서식의 입력란은 roleIndex 로 역할을 가리킵니다. 문서의 participantIndex 와 이름만 다르고 뜻은 같습니다. 0부터 시작하는 roles 배열 인덱스입니다.

요금제

서식은 베이직 요금제부터 쓸 수 있습니다. 무료 워크스페이스에서 POST /templates 를 부르면 403 이 돌아옵니다.

원본 PDF 받기

GET /templates/:id/file 은 저장해 둔 원본 PDF 를 그대로 내려줍니다. Content-Type: application/pdf 입니다.

이전서명 요청 만들기 다음서식으로 발송

더 궁금한 점이 있나요?

콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.

서식 만들기

bash

curl -X POST https://api.pindersign.net/v1/templates \
  -H "Authorization: Bearer psk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "표준 근로계약서",
    "fileBase64": "JVBERi0xLjcKJc…",
    "roles": [{ "name": "근로자" }],
    "fields": [
      { "type": "signature", "page": 2,
        "x": 0.6, "y": 0.8, "w": 0.22, "h": 0.07,
        "required": true, "roleIndex": 0 }
    ]
  }'

목록 응답

json

[
  {
    "id": "e5192f2c…",
    "title": "표준 근로계약서",
    "pageCount": 2,
    "roles": [{ "name": "근로자" }],
    "fields": [ … ],
    "createdAt": "2026-09-10T02:11:00.000Z"
  }
]