v1

latestOpenAPI 3.0.02026-07-2457351270.1 KB
USER API

템플릿/문서 병합

여러 개의 템플릿 또는 파일을 하나의 임시 템플릿으로 병합하는 API입니다.

생성된 템플릿의 pdf 페이지는 요청의 sources 순서대로 병합됩니다.

sources 중 첫 번째 요소가 기준이 되어, 정해진 병합 규칙을 바탕으로 데이터들이 병합됩니다.

기타 정보:

  • 유효기간: 2시간
post/templates/merge

Request body

Example request

{
  "sources": [
    {
      "participants": [
        {
          "role": "근로자",
          "name": "김모두",
          "signingOrder": 1,
          "signingMethod": {
            "value": "modu.kim@modusign.co.kr / 01012345678"
          },
          "attachmentRequests": [
            {
              "name": "첨부파일 1",
              "message": "2개월 내에 발급받은 회사 직인이 찍힌 원천징수영수증"
            }
          ],
          "fields": [
            {
              "type": "CHECKBOX"
            }
          ],
          "checkboxFieldGroups": [
            {
              "maxCheckLimit": 1
            }
          ]
        }
      ],
      "requesterInputs": [
        {
          "dataLabel": "기타사항",
          "type": "TEXT",
          "value": "기타사항입니다"
        }
      ],
      "requesterAttachments": [
        {
          "name": "첨부파일 1",
          "file": {
            "name": "첨부파일_1"
          }
        }
      ]
    }
  ]
}

Response

idstring required

템플릿의 ID

titlestring required

템플릿 제목

createdAtstring date-time required

템플릿 생성 시간

updatedAtstring date-time required

템플릿 마지막 업데이트 시간

requesterEditableboolean required

템플릿으로 서명 요청 시 문서의 내용이 변경 가능한 여부 (false 인 경우 기본적인 발송 설정을 제외한, 서명자 필드와 같은 데이터를 수정하여 발송할 수 없습니다)

expiredAtstring date-time required

임시 Template 만료 시각 (생성 후 2시간)

Example response

{
  "requesterInputs": [
    {
      "type": "TEXT"
    }
  ],
  "participants": [
    {
      "fields": [
        {
          "type": "SIGNATURE",
          "required": true
        }
      ],
      "fieldGroups": [
        {
          "type": "CHECKBOX_GROUP"
        }
      ]
    }
  ],
  "requesterEditable": true,
  "expiredAt": "2026-03-31T16:00:00.000Z"
}