서명 요청 / 대량 발송

대량 발송

같은 서식을 여러 사람에게 각각 별개 문서로 보냅니다. 근로계약서처럼 상대마다 계약이 따로인 경우입니다. 한 문서에 여러 명을 넣는 것과 다릅니다.

POST/requests/bulk

templateIdstring필수

서명자가 1명인 서식만 됩니다

rowsobject[]필수

`{ name, contact }` 배열. 한 번에 최대 100건

titleTemplatestring옵션

`{name}` 이 각 행의 이름으로 바뀝니다. 기본 `{name} <서식 제목>`

dueDaysnumber옵션

기한(일). 기본 14

파라미터타입필수설명

templateIdstring필수서명자가 1명인 서식만 됩니다

rowsobject[]필수{ name, contact } 배열. 한 번에 최대 100건

titleTemplatestring옵션{name} 이 각 행의 이름으로 바뀝니다. 기본 {name} <서식 제목>

dueDaysnumber옵션기한(일). 기본 14

건수와 부분 실패

시작 전에 필요한 건수를 확인합니다. 100명에게 보내는데 90건만 남았으면 한 건도 보내지 않고 400 입니다
발송 자체는 건별로 진행합니다. 20명 중 3명이 실패해도 나머지 17명은 나갑니다
응답의 results 에 건별 성공·실패와 사유가 들어 있습니다

대량 발송은 프로 요금제부터입니다. 서식의 역할이 둘 이상이면 400 이 돌아옵니다. 그런 문서는 requests/with-template 로 한 건씩 보내세요.

이전서식으로 발송 다음문서 조회

더 궁금한 점이 있나요?

콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.

대량 발송

bash

curl -X POST https://api.pindersign.net/v1/requests/bulk \
  -H "Authorization: Bearer psk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "e5192f2c…",
    "titleTemplate": "{name} 근로계약서",
    "rows": [
      { "name": "김하늘", "contact": "haneul@partner.co" },
      { "name": "이서준", "contact": "seojun@example.com" }
    ]
  }'

응답

json

{
  "total": 2,
  "sent": 1,
  "failed": 1,
  "results": [
    { "name": "김하늘", "contact": "haneul@partner.co",
      "ok": true, "documentId": "8f2a…" },
    { "name": "이서준", "contact": "seojun@example.com",
      "ok": false,
      "error": "연락처 형식이 올바르지 않습니다" }
  ]
}