Improved

1.45.0

첨부파일 개수 제한 통합 (Unified Attachment Limit)

문서·템플릿 생성 시 적용되던 요청자 첨부파일 전용 개수 제한(최대 5개)을 제거하고, 모든 첨부파일을 전체 첨부파일 상한(서명자 + 요청자 합산 최대 30개) 하나로 통합했습니다.

기존에는 요청자 첨부파일이 5개로 제한되어 있었으나, 이제 서명자·요청자 구분 없이 전체 30개 한도 내에서 자유롭게 첨부할 수 있습니다.

💡

변경 요약

  • 이전: 요청자 첨부파일 최대 5개 + 전체 첨부파일 최대 30개
  • 이후: 전체 첨부파일 최대 30개 (요청자 전용 제한 없음)

적용 대상 API

API변경 내용
서명 요청 (POST /documents)요청자 첨부파일 5개 제한 해제
템플릿 생성 (POST /templates)요청자 첨부파일 5개 제한 해제
템플릿 병합 (POST /templates/merge)요청자 첨부파일 5개 제한 해제
⚠️

전체 첨부파일 합산 30개제한은 변경 없이 유지됩니다.


입력란 정규 표현식 형식 지원 (Text Field Regex Format)

서명자 입력란(TEXT 필드)에 정규 표현식(REGEX) 기반 커스텀 입력 형식을 지정할 수 있습니다. 휴대폰 번호·계좌 번호·사업자 등록 번호 등 사전 정의 형식 외에, 직접 정의한 정규식으로 서명자가 입력한 값의 유효성을 검증합니다.

기존에는 사전 정의된 형식만 사용할 수 있었으나, 이제 format.typeREGEX로 지정하고 name·pattern을 함께 전달하면 원하는 입력 규칙을 자유롭게 적용할 수 있습니다.

💡

사용 방법

  • 입력란 객체의 format 필드로 형식을 지정합니다. (미지정 시 형식 제한 없이 자유 입력)
  • REGEX 형식: name(형식 이름, 1–50자) + pattern(정규식 패턴, 1–50자)을 함께 전달합니다.

적용 대상 API

API변경 내용
서명 요청 (POST /documents)입력란 formatREGEX 형식 추가
임베디드 초안 생성 (POST /embedded-drafts)입력란 formatREGEX 형식 추가
템플릿 생성 (POST /templates)입력란 formatREGEX 형식 추가

사용 예시

{
  "fields": [
    {
      "type": "TEXT",
      "dataLabel": "resident_number",
      "format": {
        "type": "REGEX",
        "name": "주민등록번호",
        "pattern": "^\\d{6}-\\d{7}$"
      }
    }
  ]
}

정규식 패턴 참고 예시

자주 사용되는 입력 형식의 정규식 패턴입니다. pattern 값으로 그대로 사용하거나, 필요에 따라 수정하여 활용하세요.

name (형식 이름)pattern (정규식 패턴)
건강보험번호^\d{11}$
국제 휴대전화^\+\d{1,3}[\s-]?\d{2,4}[\s-]?\d{3,4}[\s-]?\d{4}$
금액^\d{1,3}(?:,\d\d\d)*$
법인등록번호^\d{6}-\d{7}$
여권번호^[A-Z]\d{8}$
영문 이름^[A-Za-z\s]{2,30}$
외국인등록번호^\d{6}-\d{7}$
우편번호^\d{5}$
운전면허번호^\d{2}-\d{2}-\d{6}-\d{2}$
이메일^[^@\s]+@[^@\s.]+(\.[^@\s.]+)+$
일반 전화번호^0\d{1,2}-\d{3,4}-\d{4}$
주민등록번호^\d{6}-\d{7}$
차량번호^\d{2,3}[가-힣]\s?\d{4}$
카드 CVC^\d{3,4}$
카드 유효기간^(0[1-9]|1[0-2])/\d{2}$
카드번호^\d{4}-\d{4}-\d{4}-\d{4}$
한글 이름^[가-힣]{2,5}$
⚠️
  • REGEX 형식은 name·pattern이 모두 필수이며, 각각 최대 50자입니다.
    • 유효하지 않은 정규식 패턴은 요청 시점에 거부됩니다.
    • 위 패턴은 참고용 예시이며, 실제 서비스 요건에 맞게 검증 후 사용 부탁드립니다.