Improved
1.45.0
17 days ago
첨부파일 개수 제한 통합 (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.type을 REGEX로 지정하고 name·pattern을 함께 전달하면 원하는 입력 규칙을 자유롭게 적용할 수 있습니다.
사용 방법
- 입력란 객체의
format필드로 형식을 지정합니다. (미지정 시 형식 제한 없이 자유 입력)REGEX형식:name(형식 이름, 1–50자) +pattern(정규식 패턴, 1–50자)을 함께 전달합니다.
적용 대상 API
| API | 변경 내용 |
|---|---|
서명 요청 (POST /documents) | 입력란 format에 REGEX 형식 추가 |
임베디드 초안 생성 (POST /embedded-drafts) | 입력란 format에 REGEX 형식 추가 |
템플릿 생성 (POST /templates) | 입력란 format에 REGEX 형식 추가 |
사용 예시
{
"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자입니다.
- 유효하지 않은 정규식 패턴은 요청 시점에 거부됩니다.
- 위 패턴은 참고용 예시이며, 실제 서비스 요건에 맞게 검증 후 사용 부탁드립니다.
