개발자 센터

파일 합성 작업 상세 정보 조회

GET /esignglobal/v1/templates/renderTask

인터페이스 설명

템플릿 작성 후 생성된 파일을 조회합니다.

요청 파라미터

파라미터 이름

유형

필수 여부

설명

taskId

string

true

파일 합성 작업 ID

요청 예시

{
    "taskId": "ccecc62f55a64733a028cb08b406f1b7"
}

응답 파라미터

파라미터 이름

유형

설명

taskId

string

파일 합성 작업 ID

taskStatus

string

파일 합성 상태

1-합성 중

2-합성 성공

3-합성 실패

description

string

합성 실패 원인 설명, taskStatus가 3일 때만 반환, 다른 상태에서는 반환하지 않음

fileKey

string

합성 후 생성된 파일 ID, 합성 성공 시에만 반환

downloadUrl

string

합성 후 파일 다운로드 주소(유효 기간 60분), 합성 성공 시에만 반환

fieldsarray컨트롤 정보
 fieldIdstring컨트롤 ID
 fieldKeystring컨트롤 코드
 fieldNamestring컨트롤 이름
 fieldTypeint

컨트롤 유형:

25-서명 영역

26-도장 영역

 fieldConfigsobject컨트롤 설정
  pageNostring컨트롤이 있는 페이지 번호
  posXfloat컨트롤 X축 좌표
  posYfloat컨트롤 Y축 좌표
  heightfloat컨트롤 높이, 단위: px
  widthfloat컨트롤 너비, 단위: px

응답 예시

{
    "code": "0",
    "data": {
        "downloadUrl": "https://global-dev.s3.cn-northwest-1.amazonaws.com.cn/epaas-docedit/9c4aa968-92a3-4346-8a33-528e584f79d4/pdf%20%E5%9B%BE%E7%89%87%E8%B5%84%E6%BA%90%E6%89%BE%E4%B8%8D%E5%88%B0bug%E9%AA%8C%E8%AF%81.pdf?response-content-disposition=attachment&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIASKKKTSYU5RW7YI4L%2F20240830%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Date=20240830T091607Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=c7bc64eacd705af6144e3aafe7c4507ac79518d25cc95e7654c87e89b836047f",
        "fileKey": "$9cd40d42-b472-479c-bf3c-93ed8efc2863$3429580140",
        "taskId": "ccecc62f55a64733a028cb08b406f1b7",
        "taskStatus": "2"
    },
    "message": "success"
}

 

인터페이스 설명
요청 파라미터
요청 예시
응답 파라미터
응답 예시