개발자 센터

템플릿을 작성하여 파일 생성

POST /esignglobal/v1/templates/createFileByTemplate

인터페이스 설명

계약 템플릿 번호 기준templateId템플릿의 컨트롤을 사용하여 사용자 정의 콘텐츠를 채우고 최종적으로 PDF 파일을 비동기적으로 생성합니다.

호출하기 전에 템플릿 상태가 활성화되었는지 확인하십시오.

요청 매개변수

매개변수 이름

유형

필수 여부

설명

templateId

string

true

계약 템플릿 ID

fileName

string

false

생성된 파일 이름

참고: 파일 이름에 다음 9개의 특수 문자(/ \ : * " < > | ?)와 모든 이모티콘을 포함할 수 없습니다.

fields

array

false

템플릿의 컨트롤 목록 정보(컨트롤 ID와 컨트롤 키 중 하나를 선택하여 값을 전달)

 

fieldId

string

false

컨트롤 ID(계약 템플릿 설정 시 eSignGlobal 시스템에서 자동 생성)

 

fieldKey

string

false

컨트롤 Key(계약 템플릿 설정 시 사용자 정의)

 

fieldValue

string

false

컨트롤 채우기 값
(1) 컨트롤 유형에 따라 채울 수 있습니다.
(2) 동적 테이블 컨트롤을 채울 때 새 행 데이터를 추가해야 하는 경우 insertRow 매개변수 값을 true로 전달해야 합니다.

callBackUrl

string

false

콜백 주소(최대 길이 500), 유효한 https 주소여야 함

요청 예시

{
    "templateId": "1866fd459647435b98f7d40b2a9bc33e",
    "fields": [
        {
        	"fieldKey": "Number",
        	"fieldValue": "120000100101.001"
        },
        {
        	"fieldKey": "Date",
        	"fieldValue": "2025-07-07"
        },
        {
        	"fieldKey": "Checkbox",
        	"fieldValue": "[0,1,2]"
        },
        {
        	"fieldKey": "Radio",
        	"fieldValue": "1"
        },
        {
        	"fieldKey": "Select",
        	"fieldValue": "0"
        },
        {
        	"fieldKey": "Email",
        	"fieldValue": "test@gmail.com"
        },
        {
        	"fieldKey": "mergeFilling",
        	"fieldValue": "eSignGlobal"
        },
        {
        	"fieldKey": "tabkey",
        	"fieldId": "537c875667f24b9782a7bb42f1dc98b2",
        	"fieldValue": "[{\"row\":{\"column1\":\"Name\"}},{\"row\":{\"column1\":\"Jack\"}},{\"insertRow\":\"true\",\"row\":{\"column1\":\"Mike\"}}]"
        },
        {
        	"fieldId": "4d25013762f042758cdd727a9d4f8029",
        	"fieldKey": "",
        	"fieldValue": "123"
        }
    ]
}

응답 매개변수

매개변수 이름

유형

설명

taskId

string

파일 합성 작업 ID

응답 예시

{
    "code": "0",
    "data": {
        "taskId": "7e6d1125dc164fa4b2c268f8bb809dea"
    },
    "message": "success"
}

컨트롤 채우기 예시 설명

컨트롤 유형

컨트롤 채우기 예시 값

구체적인 설명

단일 행 텍스트

"구체적인 텍스트 XXXXX"

채울 구체적인 텍스트

여러 행 텍스트

"여러 행 텍스트\n여러 행 텍스트"

채울 구체적인 텍스트,\n 줄 바꿈 실행

숫자

"12345"

정수 및 소수 지원

날짜

"2025-01-01"

기본 형식은 yyyy-MM-dd입니다.

지정된 형식 지원:

yyyy년 MM월 dd일

yyyy-MM-dd

yyyy/MM/dd

dd.MM.yyyy

MM dd,yyyy

dd MM yyyy

단일 선택

"1"

0부터 정렬 시작,0옵션 1을 나타내고,1옵션 2를 나타냅니다....

다중 선택

"[0,1,2]"

0부터 정렬 시작,0옵션 1을 나타내고,1옵션 2를 나타냅니다....

체크 표시

"0" 、"1"、"2"

0 - 선택되지 않음

1 - 선택됨 ✓

2 - 엑스 ✗("엑스 표시 허용" 옵션을 템플릿 구성에서 활성화해야 함)

드롭다운 선택

"0"

0부터 정렬,0옵션 1을 나타내고,1옵션 2를 나타냅니다....

이미지

"URL"

이미지 링크를 업로드해야 합니다.

동적 테이블

[{\"row\":{\"column1\":\"구체적인 내용\"}},{\"row\":{\"column1\":\"구체적인 내용\"}},{\"insertRow\":\"true\",\"row\":{\"column1\":\"Mike\"}}]

row는 동적 테이블의 행 데이터이며, row의 개수는 동적 테이블 제작 시 추가된 테이블 행 수입니다. row의 column1은 현재 행에서 열이 column1인 셀의 키 값이며, column2는 열이 column2인 셀의 키 값입니다.

이메일

"123456@XX.com"

이메일 주소

인터페이스 설명
요청 매개변수
요청 예시
응답 매개변수
응답 예시
컨트롤 채우기 예시 설명