전자서명 API 연동

내 서비스에서 서명 요청을 보내려면 API 키를 써요. 키는 확인된 이메일 하나에 묶여요. 웹에서 직접 보낼 때는 키가 필요 없어요.

API 키

키를 만들 때마다 내 이메일로 확인 메일이 가요. 메일의 링크를 누르면 (휴대폰에서 눌러도) 이 화면에 키가 한 번만 보여요. 서버에는 키의 해시만 남아요.

요청 보내기

curl -X POST https://signs.bongkow.com/v1/requests \
  -H "Authorization: Bearer bks_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-order-0001" \
  -d '{
    "title": "용역계약서",
    "file": "<PDF base64>",
    "signers": [{ "name": "홍길동", "email": "[email protected]" }],
    "message": "확인 후 서명 부탁드려요."
  }'

응답은 201이에요. 키로 보낸 요청은 확인 없이 바로 서명자에게 메일이 가요.
선택: fields(서명 칸, 0~1 비율), expires_in_days(1~90, 기본 14), delivery(email | none), embed.
같은 Idempotency-Key로 다시 보내면 첫 응답을 그대로 줘요. 본문이 다르면 409예요.
상태 보기: GET /v1/requests/{id}. 완료본: GET /v1/requests/{id}/signed.pdf.
오류: {"error":{"code","message"}}. 401 키 없음, 402 이번 달 무료 상한, 429 너무 잦은 요청.

상한

확인된 이메일마다 한 달(한국 시간) 30건이에요. 웹과 API를 합쳐 세요.
PDF는 20MB, 서명자는 10명까지예요.

자주 묻는 질문

웹에서 보낼 때도 API 키가 필요한가요?

아니요. 웹에서는 내 이메일만 적으면 돼요. 처음 쓰는 기기에서만 내 메일함의 확인 링크를 한 번 눌러요. API 키는 내 서비스에서 연동할 때만 써요.

API 키는 어떻게 만드나요?

이 페이지에서 이메일과 키 이름을 적고 확인 메일을 받아요. 메일의 링크를 누르면 키가 화면에 한 번만 보여요. 키는 그 이메일에 묶여요.

무료로 몇 건까지 보낼 수 있나요?

확인된 이메일마다 한 달(한국 시간) 30건이에요. 웹과 API로 보낸 것을 합쳐 세요. +태그 주소는 원래 주소와 합쳐 세요.