Anchor 기반 필드 자동 배치

API 연동을 통해 가변 문서에 대해서도 수동 좌표 설정 없이 간편하게 서명 준비를 할 수 있게 되었습니다. PDF 등의 문서 내 특정 텍스트를 앵커로 지정하면, 서명/텍스트 입력란이 해당 위치에 자동으로 생성됩니다.

적용 API

엔드포인트	메서드	설명
/documents	POST	서명 요청

사용 방법

필드 생성 시 기존 position의 좌표(x, y, page) 대신 position.anchor 속성을 사용하여 텍스트 기반 위치를 지정합니다.

문서 내 텍스트를 기준으로 필드 위치를 자동 지정합니다.

{
  "type": "TEXT",
  "position": {
    "anchor": {
      "text": "이름",
      "offset": {
        "x": 0.01,
        "y": 0.005
      }
    }
  },
  "size": {
    "width": 0.2,
    "height": 0.05
  }
}

Anchor 파라미터

position.anchor 객체의 구조는 다음과 같습니다.

파라미터	타입	필수	설명
text	string	✓	문서 내에서 찾을 기준 텍스트
offset	object \| null		기준 텍스트로부터의 오프셋. null이면 텍스트 위치에 필드 배치
offset.x	number		X축 오프셋 (양수: 오른쪽, 음수: 왼쪽)
offset.y	number		Y축 오프셋 (양수: 아래쪽, 음수: 위쪽)

필드 크기는 기존과 동일하게 size 객체로 지정합니다.

파라미터	타입	필수	설명
size.width	number	✓	필드 너비 (0~1)
size.height	number	✓	필드 높이 (0~1)

지원 필드 타입

타입	설명
TEXT	텍스트 입력 필드
SIGNATURE	서명 필드

⚠️
주의사항

position에 좌표(x, y, page)와 anchor를 동시에 지정할 수 없습니다. 둘 중 하나만 사용하세요.

둘 다 지정하면 유효성 검사 오류가 발생합니다.

문서 내에 지정한 텍스트가 없으면 AnchorTextNotFoundException (404) 오류가 발생합니다.