eSign.AIeSign.AI
개발자 센터

서명 파일 추가

POST /esignglobal/v1/envelope/files/addSignFiles

인터페이스 설명

봉투가 아직 열리지 않은 경우, 봉투에 서명 대기 파일을 추가할 수 있습니다. 이미 열린 봉투에는 서명 파일을 추가로 첨부할 수 없습니다.

요청 매개변수

매개변수 이름

유형

필수 여부

설명

envelopeId

string

true

봉투 ID

signFiles

array

true

서명 파일 정보 집합. 표시 순서는 파일 추가 순서와 동일합니다.

 

fileKey

string

true

서명 파일 fileKey. PDF 형식만 지원됩니다.

 documentFieldsarrayfalse파일 차원 위젯 목록. 서명자와 바인딩되지 않은 파일 차원 위젯을 지정된 파일에 추가하는 데 사용됩니다.
  

fieldType

string

false

위젯 유형. eMeterai를 전달하면 인도네시아 스탬프 세금 위젯을 나타냅니다.

  

pageNo

string

false

위젯이 위치한 페이지 번호. 인도네시아 스탬프 세금 위젯은 단일 페이지만 지정할 수 있으며, 개별 페이지 번호만 전달해야 합니다. 1-3, 1,3 등과 같은 연속 또는 비연속 다중 페이지 형식은 지원되지 않습니다.

  posXfloatfalsex축 오프셋. 페이지 좌측 하단이 좌표 원점입니다. 좌표 범위는 다른 위젯의 좌표 범위와 동일합니다.
  posYfloatfalsey축 오프셋. 페이지 좌측 하단이 좌표 원점입니다. 좌표 범위는 다른 위젯의 좌표 범위와 동일합니다.

요청 예시

{   
  "envelopeId": "9fbe6c8190824227bde29136b0145c81",
  "signFiles": [
  {
    "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
  }
]
}

응답 매개변수

매개변수 이름

유형

설명

code

int

비즈니스 코드, 0은 성공을 의미하고, 0이 아닌 값은 오류를 의미합니다.

message

string

비즈니스 정보

[주의] message는 조정될 수 있으므로 message 매칭에 의존하지 말고 code를 기준으로 오류 상황을 판단해야 합니다.

data

object

비즈니스 데이터

응답 예시

{
    "code": "0",
    "message": "success",
    "data": null
}