서명 필드(Field)

**서명 필드(Field)**는 "누가 어디에 무엇을" 남길지 정의합니다. 위치는 페이지 기준 0~1 비율 좌표입니다.

객체 구조

{
  "id": "fld_9x...",
  "object": "field",
  "participant_id": "par_1a2b...",
  "type": "signature",
  "page": 1,
  "x": 0.62, "y": 0.80,
  "width": 0.25, "height": 0.08,
  "required": true,
  "upload_only": false
}

필드 종류(type)

좌표계

x,y는 필드 좌상단의 위치, width,height는 크기이며 모두 페이지 너비/높이에 대한 0~1 비율입니다. 화면 해상도와 무관하게 같은 위치에 표시됩니다.

날인 전용 옵션

type이 seal이고 upload_only가 true면, 서명자는 자동 생성 도장을 쓸 수 없고 실물 도장 스캔 이미지 업로드만 허용됩니다.