전자서명 템플릿 목록 조회 API

현재 비즈니스에 등록된 전자서명 템플릿 목록을 확인할 수 있습니다.

GET kit-api/v1/signature-templates

Method: GET Endpoint: kit-api/v1/signature-templates

Example

...kit-api/v1/signature-templates?limit=10&offset=0

Request Query

Key	Description	Required
limit	목록 개수 (default 10, max 100)	no
offset	스킵할 목록 개수	no
title	전자서명 템플릿 이름으로 필터 (string)	no
tagIds	연결된 계약서 태그로 필터 (쉼표로 구분: ex. tagIds=2,3)	no
signatureCount	연결된 서명 개수도 함께 조회할지 여부 (true, false)	no
slug	템플릿의 slug 값으로 필터 (string)	no

Response

{
  "ok": true, // api 성공 여부
  "message": undefined, // Error가 존재하면 message(string)로 전달
  "data": {
    "templates": [
      // 전자서명 템플릿 목록 (계약서의 파일은 계약서 상세 조회 API에서 조회할 수 있습니다.)
      {
        "id": 12345, // 고유 식별 id
        "name": "MOU 템플릿", // 전자서명 템플릿 이름
        "participantType": "TOGETHER", // 서명 타입 (순서대로 서명 여부 - TOGETHER, ORDER)
        "slug": "test_slug_03232", // slug(문자)
        "ccEmails": ["[email protected]"], // 워크플로우 이메일 참조자
        "createdAt": "2024-07-15T00:00:00.000Z", // 생성일
        "updatedAt": "2024-07-15T00:00:00.000Z", // 수정일
        "managerNames": ["이용우"], // 계약서 담당자 이름 목록
        "signatureCount": 3, // signatureCount=true로 넘긴 경우에만 확인 가능
        "participants": [
          {
            // 전자서명 참여자
            "id": 987, // 고유 식별 id
            "order": 1, // 전자서명 참여 순서
            "role": "고객" // 역할 이름 (ex. 갑, 고객, 등)
          }
        ]
      }
    ],
    "total": 1
  }
}