파일 템플릿 생성 페이지 링크 가져오기

POST /esignglobal/v1/templates/create

API 설명

파일 템플릿 생성 페이지 링크를 가져옵니다.

개발자는 해당 API를 통해 유효 기간이 있는 파일 템플릿 생성 페이지 링크를 받을 수 있습니다. docTemplateCreateUrl , 해당 링크를 열어 운영자가 페이지에서 지정된 파일을 기반으로 파일 템플릿을 생성할 수 있게 합니다.

주의사항

fileKey 업로드 파일 API를 통해 획득한 파일 KEY이며, 이번 템플릿 생성 기준 파일을 지정하는 데 사용됩니다.
docTemplateType 기본값은 0 , PDF 템플릿을 나타냅니다. 를 전달하면2 경우 HTML 템플릿을 의미하며, 테이블 행을 동적으로 추가하고 내용을 채우는 경우에 적합합니다.
API 호출 성공 시 반환되는 docTemplateCreateUrl , 해당 링크는 유효 기간이 있으므로 획득 후 즉시 사용하시길 권장하며, 장시간 캐싱하는 것은 권장하지 않습니다.
개발자는 redirectUrl 템플릿 생성 완료 후 이동할 페이지를 지정할 수 있습니다.

요청 파라미터

파라미터 이름	유형	필수 여부	설명
docTemplateName	string	true	파일 템플릿 이름, 사용자 정의 가능.
fileKey	string	true	파일 KEY, 파일 업로드 인터페이스를 통해 가져옵니다.
docTemplateType	int	false	파일 템플릿 유형, 기본값은 `0`。 `0`: PDF 템플릿입니다. `2`: HTML 템플릿으로, 테이블 행을 동적으로 추가하여 내용을 채우는 경우에 적합합니다.
redirectUrl	string	false	템플릿 생성 완료 후 이동할 링크로, 유효한 URL이어야 합니다.

요청 예시

{
  "docTemplateName": "Sales Contract Template",
  "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c",
  "docTemplateType": 0,
  "redirectUrl": "https://example.com/template/create/callback"
}

응답 파라미터

파라미터 이름		유형	설명
code		int	상태 코드.
message		string	응답 정보.
data		object	응답 데이터.
	docTemplateId	string	신규 파일 템플릿 ID.
	docTemplateCreateUrl	string	파일 템플릿 생성 페이지 링크(유효 기간 제한 있음).

응답 예시

{
  "code": 0,
  "message": "success",
  "data": {
    "docTemplateId": "template_123456789",
    "docTemplateCreateUrl": "https://app.esignglobal.com/template/create?token=example"
  }
}