PacteryDevelopers

서명자 일괄 등록

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 서명자에 휴대폰 누락