--- title: "템플릿 정보 가져오기" method: GET path: "/templates/{templateId}" tags: ["USER API"] --- # 템플릿 정보 가져오기 `GET /templates/{templateId}` ## Path parameters - `templateId` string, required ## Response `200` - GetTemplateResponseDto - `id` string, required — 템플릿의 ID - `metadatas` MetadataInTemplateResponseDto[], required — 메타데이터 리스트 - `key` string, required — 메타데이터 키 - `value` string, required — 메타데이터 값 - `title` string, required — 템플릿 제목 - `createdAt` string, date-time, required — 템플릿 생성 시간 - `updatedAt` string, date-time, required — 템플릿 마지막 업데이트 시간 - `file` TemplateFileInTemplateResponseDto - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분) - `requesterInputs` union[], required — 템플릿에 적용된 추가내용 입력 - union - TextRequesterInputInTemplateResponseDto - `dataLabel` string, required — 데이터 라벨 - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다) - `position` PositionInTemplateResponseDto, required - `x` number, required — 입력란의 가로 좌표 - `y` number, required — 입력란의 세로 좌표 - `page` integer, required — 입력란이 위치할 페이지 - `size` SizeInTemplateResponseDto, required - `width` number, required — 입력란의 너비 - `height` number, required — 입력란의 높이 - `textStyle` TextStyleInTemplateResponseDto, required - `size` integer, required — 텍스트 크기 - `font` string, required — 텍스트 글자체 - `align` string, required — 텍스트 정렬 - `value` string, required — 텍스트 박스에 들어갈 내용 - CheckboxRequesterInputInTemplateResponseDto - `dataLabel` string, required — 추가내용 입력의 데이터 라벨 - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다) - `position` PositionInTemplateResponseDto, required - `x` number, required — 입력란의 가로 좌표 - `y` number, required — 입력란의 세로 좌표 - `page` integer, required — 입력란이 위치할 페이지 - `size` SizeInTemplateResponseDto, required - `width` number, required — 입력란의 너비 - `height` number, required — 입력란의 높이 - `value` boolean, required — 체크 박스의 체크 여부 - ImageRequesterInputInTemplateResponseDto - `dataLabel` string, required — 데이터 라벨 - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다) - `position` PositionInTemplateResponseDto, required - `x` number, required — 입력란의 가로 좌표 - `y` number, required — 입력란의 세로 좌표 - `page` integer, required — 입력란이 위치할 페이지 - `size` SizeInTemplateResponseDto - `width` number, required — 입력란의 너비 - `height` number, required — 입력란의 높이 - `value` ImageInfoInTemplateResponseDto - `downloadUrl` string, required — 이미지 다운로드 링크 (10분간 유효) - DropdownRequesterInputInTemplateResponseDto - `dataLabel` string, required — 데이터 라벨 - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다) - `position` PositionInTemplateResponseDto, required - `x` number, required — 입력란의 가로 좌표 - `y` number, required — 입력란의 세로 좌표 - `page` integer, required — 입력란이 위치할 페이지 - `size` SizeInTemplateResponseDto - `width` number, required — 입력란의 너비 - `height` number, required — 입력란의 높이 - `textStyle` TextStyleInTemplateResponseDto, required - `size` integer, required — 텍스트 크기 - `font` string, required — 텍스트 글자체 - `align` string, required — 텍스트 정렬 - `options` DropdownOption[], required — 드롭다운 옵션 - `value` string, required — 드롭다운 옵션 값 - `value` string, required — 드롭다운 필드에 들어갈 내용 - NameRequesterInputInTemplateResponseDto - `dataLabel` string, required — 데이터 라벨 - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다) - `position` PositionInTemplateResponseDto, required - `x` number, required — 입력란의 가로 좌표 - `y` number, required — 입력란의 세로 좌표 - `page` integer, required — 입력란이 위치할 페이지 - `size` SizeInTemplateResponseDto - `width` number, required — 입력란의 너비 - `height` number, required — 입력란의 높이 - `textStyle` TextStyleInTemplateResponseDto, required - `size` integer, required — 텍스트 크기 - `font` string, required — 텍스트 글자체 - `align` string, required — 텍스트 정렬 - `value` string, required — 이름 필드에 들어갈 내용 - `requesterAttachments` RequesterAttachmentInTemplateResponseDto[], required — 설정된 요청자 첨부파일 정보 - `dataLabel` string, required — 요청자 첨부파일의 데이터 라벨 - `name` string, required — 첨부파일 종류 - `file` RequesterAttachmentFileInTemplateResponseDto, required - `name` string, required — 파일명 - `extension` string, required — 파일 확장자 - `size` number, required — 파일 크기 (Byte) - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분) - `participants` union[], required — 설정된 참여자 정보 - union - SignerInParticipantTemplateResponseDto - `type` 'SIGNER', required — 참여자 타입 - `role` string, required — 참여자의 역할 - `signingOrder` integer, required — 참여자의 서명/열람 순서 - `name` string — 참여자의 이름 (공란일 수 있음) - `signingMethod` SigningMethodInTemplateResponseDto - `type` 'EMAIL' | 'KAKAO' | 'SECURE_LINK' | 'IN_PERSON', required — 참여 수단 종류 - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호) - `attachmentRequests` AttachmentRequestInTemplateResponseDto[], required — 첨부파일 요청 정보 - `name` string, required — 첨부파일 종류 - `message` string, nullable — 추가 안내 사항 - `required` boolean, required — 필수 여부 - `dataLabel` string, required — 첨부파일의 데이터 라벨 - `fields` union[], required — 참여자 입력란 - union - SignatureFieldInTemplateResponseDto - … - TextFieldInTemplateResponseDto - … - CheckboxFieldInTemplateResponseDto - … - DropdownFieldInTemplateResponseDto - … - NameFieldInTemplateResponseDto - … - CompanyNameFieldInTemplateResponseDto - … - AddressFieldInTemplateResponseDto - … - DateFieldInTemplateResponseDto - … - SigningDateFieldInTemplateResponseDto - … - ImageFieldInTemplateResponseDto - … - `fieldGroups` union[], required — 참여자 입력란 그룹 - union - CheckboxFieldGroupInTemplateResponseDto - … - AutofillFieldGroupInTemplateResponseDto - … - `checkboxFieldGroups` DeprecatedCheckboxFieldGroupInTemplateResponseDto[], required — 체크박스 그룹 (deprecated 되었으며 fieldGroups를 대신 활용해주세요) - `groupLabel` string, required — 체크박스 그룹 라벨 - `minCheckRequired` number, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다. - `maxCheckLimit` number, nullable, required — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다. - `verification` VerificationInTemplateResponseDto, required - `password` ParticipantPasswordInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - `mobileIdentification` ParticipantMobileIdentificationInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - `dCert` ParticipantDCertInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - ViewerInParticipantTemplateResponseDto - `type` 'VIEWER', required — 참여자 타입 - `role` string, required — 참여자의 역할 - `signingOrder` integer, required — 참여자의 서명/열람 순서 - `name` string — 참여자의 이름 (공란일 수 있음) - `signingMethod` SigningMethodInTemplateResponseDto - `type` 'EMAIL' | 'KAKAO' | 'SECURE_LINK' | 'IN_PERSON', required — 참여 수단 종류 - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호) - `attachmentRequests` AttachmentRequestInTemplateResponseDto[], required — 첨부파일 요청 정보 - `name` string, required — 첨부파일 종류 - `message` string, nullable — 추가 안내 사항 - `required` boolean, required — 필수 여부 - `dataLabel` string, required — 첨부파일의 데이터 라벨 - `fields` union[], required — 참여자 입력란 - union - SignatureFieldInTemplateResponseDto - … - TextFieldInTemplateResponseDto - … - CheckboxFieldInTemplateResponseDto - … - DropdownFieldInTemplateResponseDto - … - NameFieldInTemplateResponseDto - … - CompanyNameFieldInTemplateResponseDto - … - AddressFieldInTemplateResponseDto - … - DateFieldInTemplateResponseDto - … - SigningDateFieldInTemplateResponseDto - … - ImageFieldInTemplateResponseDto - … - `fieldGroups` union[], required — 참여자 입력란 그룹 - union - CheckboxFieldGroupInTemplateResponseDto - … - AutofillFieldGroupInTemplateResponseDto - … - `checkboxFieldGroups` DeprecatedCheckboxFieldGroupInTemplateResponseDto[], required — 체크박스 그룹 (deprecated 되었으며 fieldGroups를 대신 활용해주세요) - `groupLabel` string, required — 체크박스 그룹 라벨 - `minCheckRequired` number, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다. - `maxCheckLimit` number, nullable, required — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다. - `verification` VerificationInTemplateResponseDto, required - `password` ParticipantPasswordInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - `mobileIdentification` ParticipantMobileIdentificationInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - `dCert` ParticipantDCertInTemplateResponseDto - `enabled` boolean, required — 추가 인증 사용 여부 - `manuallyViewing` boolean, required — 상세 열람 여부 - `documentLabels` DocumentLabelInTemplateResponseDto[], required — 해당 템플릿으로 참여 요청 시 자동으로 적용될 라벨 목록 - `id` string, required — 라벨 ID - `name` string, required — 라벨 이름 - `description` string, nullable, required — 라벨의 설명 - `requesterEditable` boolean, required — 템플릿으로 서명 요청 시 문서의 내용이 변경 가능한 여부 (false 인 경우 기본적인 발송 설정을 제외한, 서명자 필드와 같은 데이터를 수정하여 발송할 수 없습니다) - `carbonCopies` CarbonCopyInTemplateResponseDto[], required — 참조자 정보 - `contact` string, required — 참조자 연락처 - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi', required — 참조자 언어 - `seal` DocumentSealInTemplateResponseDto, required - `integritySeal` IntegritySealInTemplateResponseDto, required - `enabled` boolean, required — 진본 증명 도장 활성화 여부 - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치 --- [API](https://skmtc.net/modusign/apis/modusign-api.md) · [All operations](https://skmtc.net/modusign/apis/modusign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modusign/modusign-api/versions/5772e872cbf9/schema)