API · MCP 연동
우리 시스템과 AI 비서에
전자서명을 연결합니다
ERP·HR·CRM·자체 서비스에서 서명 요청을 보내고, 완료되면 Webhook으로 돌려받으세요. AI 비서에는 MCP 서버 하나면 됩니다. 무료 건수에서도 전부 열려 있습니다.
연동 방식
세 가지 문, 같은 기능
어느 쪽으로 들어와도 콘솔과 같은 워크스페이스·건수·템플릿을 씁니다.
REST API
서명 요청 생성·조회·취소·재발송·완료본 다운로드까지 콘솔에서 하는 일을 전부 호출할 수 있습니다. JSON만 주고받습니다.
Webhook
문서가 완료되면 지정한 URL로 이벤트를 보냅니다. HMAC 서명 헤더로 위조를 걸러내고, 실패하면 재시도합니다.
MCP (AI 비서)
Claude 등 MCP를 지원하는 AI 비서에 서버를 등록하면 "○○에게 △△ 템플릿으로 서명 요청해줘"가 그대로 실행됩니다.
시작하기
API 키 하나로 시작합니다
콘솔 설정 › API·Webhook에서 키를 발급받아 Authorization 헤더에 넣으면 됩니다. 키는 발급 시 한 번만 표시됩니다.
- Base URL
https://api.pindersign.net/v1- 인증
Authorization: Bearer psk_…— 워크스페이스 단위 API 키- 형식
- 요청·응답 모두 JSON. 파일은 base64 문자열로 보내고, 완료본은 바이너리로 내려받습니다.
- 권한
- 키마다 읽기/쓰기 범위를 둡니다. 쓰기 범위가 있어야 발송·취소·재발송이 가능합니다.
- 건수 차감
- 발송 성공 시 문서 1건당 1건. 취소하면 환불됩니다. 콘솔 발송과 같은 잔여 건수를 씁니다.
curl -X POST https://api.pindersign.net/v1/requests/with-template \
-H "Authorization: Bearer psk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"templateId": "tpl_…",
"title": "2026년 프리랜서 용역계약서",
"participants": [
{ "name": "김하늘", "contact": "haneul@partner.co" }
],
"ordered": true,
"dueDays": 14
}'엔드포인트
콘솔에서 하는 일은 전부 API로도
주요 엔드포인트입니다. 콘솔에서 API 키를 발급하면 같은 화면에서 자세한 요청 형식을 볼 수 있습니다.
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /documents | PDF(base64)·서명자·입력란으로 서명 요청 생성·발송 |
| GET | /documents | 워크스페이스 문서 목록(상태·서명자·마지막 활동일) |
| GET | /documents/:id | 문서 상세 · 서명자 상태 · 진행 이력 |
| POST | /documents/:id/remind | 미서명자에게 재발송 |
| POST | /documents/:id/cancel | 요청 취소(건수 환불) |
| GET | /documents/:id/files/:kind | 완료본(completed) · 감사추적인증서(audit) · 원본(source) 다운로드 |
| GET / POST | /templates | 템플릿 목록 · 생성 |
| POST | /requests/with-template | 템플릿으로 서명 요청(서명자만 지정) |
| POST | /requests/bulk | 템플릿으로 여러 명에게 각각 발송 |
| GET / POST | /links | 링크서명 생성 · 목록 |
| GET / POST | /contacts | 주소록 |
| GET / POST | /verify | 검증키 또는 PDF로 원본 확인 |
Webhook
완료되면 우리 쪽으로 알려줍니다
콘솔에서 URL을 등록하면 서명 시크릿이 발급됩니다. 요청 본문을 그 시크릿으로 HMAC-SHA256 서명해 헤더에 실어 보냅니다.
이벤트
document.completed(전원 서명 완료)를 기본으로 보냅니다. 등록 시 이벤트를 고를 수 있습니다.
검증
X-PinderSign-Signature 헤더의 sha256= 값을 같은 방식으로 계산해 비교하세요. 다르면 버립니다.
POST https://your-app.com/webhooks/pindersign
X-PinderSign-Signature: sha256=3f1c… // HMAC-SHA256(secret, body)
{
"event": "document.completed",
"document": { "id": "…", "title": "…", "status": "completed",
"verificationKey": "…", "completedAt": "…" }
}MCP
AI 비서에게 서명 요청을 맡깁니다
MCP 서버를 등록하면 AI가 템플릿 목록을 보고, 서명자를 되묻고, 최종 확인을 받은 뒤 발송합니다. 확정 전에는 실제 발송이 일어나지 않습니다.
{
"mcpServers": {
"pindersign": {
"url": "https://pindersign-mcp.dploy.so/mcp",
"headers": { "Authorization": "Bearer psk_xxxxxxxx" }
}
}
}- · 템플릿 목록 조회 · 템플릿으로 서명 요청
- · 문서 목록 · 진행 상태 조회
- · 미서명자 재발송 · 요청 취소
- · 발송 전 확인(confirm) 단계 강제