싸인딜 개발자

서명 위치·좌표

PDF 위에 서명칸이나 도장칸을 놓으려면 "어디에"를 숫자로 말해야 해요. 싸인딜은 쪽마다 왼쪽 위를 0, 오른쪽 아래를 1로 쳐요. 지금 쓸 수 있는 곳은 REST의 mode: "sign_pdf"예요.

1. 한 장 그림으로 보기

00.51 (x) 0.51(y) 0,0 = 왼쪽 위 서명칸 x=0.70 y=0.82 w=0.25 · h=0.06
그림. 쪽마다 왼쪽 위가 (0, 0), 오른쪽 아래가 (1, 1)이에요. 파란 칸은 x=0.70, y=0.82에서 시작해요.

2. 칸 하나는 이렇게 적어요

{ "type": "signature",   // signature | seal | date | text | checkbox
  "role": "employee",    // roles[].id 와 같은 값
  "page": 1,             // 1쪽부터
  "x": 0.70, "y": 0.82,  // 칸의 왼쪽 위 모서리
  "w": 0.25, "h": 0.06 } // 가로·세로 크기

3. 서버가 검사하는 것

상황서버가 돌려주는 코드
칸이 용지 밖으로 나가요field_out_of_page
다른 역할의 칸과 겹쳐요field_overlap
받는 사람 역할에 서명칸이 없어요missing_signature_field

보내기 전에 dry_run(기본값)으로 먼저 확인하세요. 미리보기 뒤에 칸을 바꾸면 미리보기를 다시 해야 해요(layout_hash가 확인표에 묶여 있어요). preview_document: "pdf"를 쓰면 칸을 얹은 미리보기 PDF를 받을 수 있어요. 전체 코드는 오류 코드를 보세요.

4. 아직 준비 중인 것

아래 기능은 코드에 아직 없어서 쓸 수 없어요.