서명 위치·좌표
PDF 위에 서명칸이나 도장칸을 놓으려면 "어디에"를 숫자로 말해야 해요. 싸인딜은 쪽마다 왼쪽 위를 0, 오른쪽 아래를 1로 쳐요. 지금 쓸 수 있는 곳은 REST의 mode: "sign_pdf"예요.
1. 한 장 그림으로 보기
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 } // 가로·세로 크기
- x, y는 칸의 왼쪽 위 모서리예요.
- w, h는 쪽 크기에 대한 비율이에요. 모두 0과 1 사이 숫자예요.
- 쪽마다 크기가 달라도 같은 비율로 계산돼요.
- 칸의 종류와 최소·최대 크기, 칸 수 한도는 API 참조의
/api/contracts:send_document요청 항목에 코드 그대로 나와 있어요.
3. 서버가 검사하는 것
| 상황 | 서버가 돌려주는 코드 |
|---|---|
| 칸이 용지 밖으로 나가요 | field_out_of_page |
| 다른 역할의 칸과 겹쳐요 | field_overlap |
| 받는 사람 역할에 서명칸이 없어요 | missing_signature_field |
보내기 전에 dry_run(기본값)으로 먼저 확인하세요. 미리보기 뒤에 칸을 바꾸면 미리보기를 다시 해야 해요(layout_hash가 확인표에 묶여 있어요). preview_document: "pdf"를 쓰면 칸을 얹은 미리보기 PDF를 받을 수 있어요. 전체 코드는 오류 코드를 보세요.
4. 아직 준비 중인 것
아래 기능은 코드에 아직 없어서 쓸 수 없어요.
- 퍼센트·pt 단위로 위치 주기 준비 중 — 지금은 0~1 비율만 돼요.
- "2쪽 오른쪽 아래"처럼 말로 위치 정하기 준비 중
- 글자 옆에 칸 붙이기(예: "임대인" 오른쪽) 준비 중
- 칸 그림 미리보기와 "글 지도" 준비 중