서명자 일괄 등록
POST /v1/documents/{id}/participants/batch
여러 서명자를 한 번의 요청으로 등록합니다. 다자간 계약처럼 서명자가 많을 때 호출 수를 줄여줍니다.
본문 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
participants |
array | 서명자 추가와 동일한 객체의 배열(최대 50) |
요청 예시
curl https://api.pactery.com/v1/documents/doc_8sK2.../participants/batch \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"participants": [
{ "name": "홍길동", "phone": "01011112222", "signing_order": 1 },
{ "name": "김담당", "phone": "01033334444", "signing_order": 2 }
]
}'
응답 (201)
생성된 서명자 배열을 반환합니다.
{
"object": "list",
"data": [
{ "id": "par_1", "name": "홍길동", "signing_order": 1 },
{ "id": "par_2", "name": "김담당", "signing_order": 2 }
]
}
에러
| code | 의미 |
|---|---|
document_not_editable |
이미 발송된 문서 |
missing_phone |
sms_pin 서명자에 휴대폰 누락 |