서명자(Participant)
**서명자(Participant)**는 문서에 관여하는 사람입니다. 역할에 따라 서명/검토/참조로 나뉩니다.
객체 구조
{
"id": "par_1a2b...",
"object": "participant",
"name": "홍길동",
"email": "gildong@example.com",
"phone": "01012345678",
"role": "signer",
"signing_order": 1,
"auth": "sms_pin",
"status": "pending"
}역할(role)
| 값 | 설명 |
|---|---|
signer |
서명/날인하는 당사자 |
reviewer |
본문을 함께 검토·수정 제안 |
cc |
완료본을 참조로 받는 사람 |
본인인증(auth)
| 값 | 설명 |
|---|---|
sms_pin |
휴대폰 문자 PIN 인증(권장). 서명-본인 바인딩 + 감사기록 |
none |
링크 접근만으로 서명(낮은 신뢰 수준) |
진행 상태(status)
pending → viewed → signed (또는 rejected)
signing_order를 지정하면 순서대로 서명이 진행됩니다(앞 순서가 끝나야 다음 사람에게 발송). 같은 값이면 동시 진행입니다.