전자계약 API는 자사 시스템(ERP·CRM·백오피스)에서 계약서 생성·서명요청·체결·상태조회를 코드로 호출하는 REST 인터페이스이며, 싸인딜은 이를 `sk_` API 키 한 줄로 시작할 수 있게 베타로 제공합니다.

전자계약 API란 무엇이고 어디까지 되나

전자계약 API는 사람이 웹 화면에서 하던 "초안 작성 → 서명자 추가 → 발송 → 진행 추적"을 HTTP 요청으로 자동화하는 도구입니다. 싸인딜 REST API의 기준 주소는 `https://api.signdeal.kr/v1`이고, 인증은 `Authorization: Bearer sk_...` 헤더 하나로 끝납니다. 양식 조회(`GET /v1/templates`), 초안 생성(`POST /v1/contracts`), 서명자 추가, 발송, 상태·보존본 조회까지 한 흐름으로 묶을 수 있어 차용증 같은 단건 계약을 자동 발송 파이프라인에 태우기 좋습니다.

API로 가능한 것 / 사람이 꼭 확인해야 할 것

API로 자동화해도 "실제로 보낼지"의 최종 결정은 사람이 쥐고 있어야 합니다. 싸인딜은 발송·체결처럼 되돌리기 어려운 작업에 `dry_run`(미리보기) → `confirmation_token`(승인) 2단계를 서버단에서 강제합니다. 자동화에 적합한 것은 양식 채우기, 초안 생성, 서명자 등록, 상태 폴링, 멱등키(`Idempotency-Key`)로 중복 발송 차단입니다. 사람이 꼭 확인할 것은 수신자 연락처·금액·날짜 같은 핵심 값과 실제 발송 승인이며, AI나 코드가 만든 문안은 검토 후 보내는 것을 권장합니다.

연동 4단계: 인증키 발급 → 문서 업로드 → 서명요청 생성 → 상태 조회

가장 빠른 연동은 키 발급부터 상태 조회까지 네 번의 호출로 끝납니다.

1. 인증키 발급 — 인앱 콘솔에서 `sk_` API 키(운영/test)를 발급해 서버 환경변수에 보관합니다.

2. 문서 업로드·초안 생성 — `POST /v1/contracts`로 양식 기반 초안을 만들거나 보유 PDF를 올립니다(`GET /v1/templates`로 양식 확인).

3. 서명요청 생성 — `POST /v1/contracts/{id}/signers`로 서명자를 추가한 뒤, `POST /v1/contracts/{id}/send`를 `dry_run`으로 점검하고 `confirmation_token`으로 발송합니다.

4. 상태 조회 — `GET /v1/contracts/{id}`로 진행을, 체결 후 `GET /v1/contracts/{id}/document`로 보존본 PDF와 문서 해시(SHA-256)를 받습니다.

MCP와 API, 언제 무엇을 쓰나

AI 도구 안에서 대화로 다루려면 MCP를, 자체 서버·백오피스에 직접 붙이려면 REST API를 쓰면 됩니다. 두 경로는 같은 백엔드와 같은 안전 모델(`dry_run`→`confirmation_token`)을 공유합니다. AI(MCP)로: Claude·Codex 설정의 `mcpServers`에 `https://mcp.signdeal.kr`를 등록하면 8개 tool로 대화 중 생성·발송이 가능합니다. API로: ERP·CRM 이벤트에 맞춰 위 4단계를 코드로 호출하면 됩니다.

자주 묻는 질문

가격은 얼마인가요? 유료 플랜(발송권 충전) 회원은 API·MCP 호출 자체에 추가 요금이 0원이고, 발송 1건만 발송권에서 차감됩니다. 가입 시 무료 5건(1회성)이 있고 충전은 100건 29,900원부터(VAT 별도)이며, 받는 사람은 영원히 무료입니다.

요청 제한·샌드박스가 있나요? test 키와 `dry_run`으로 실제 발송 없이 흐름을 검증할 수 있습니다. 세부 호출 제한 정책은 정식 출시 시 OpenAPI 문서로 공개될 예정입니다.

아직 안 되는 기능은요? 웹훅, OpenAPI 스펙 공개, OAuth 2.1 동적 인증은 현재 로드맵(추진 중)이며 발송권 충전 결제도 순차 오픈됩니다. 싸인딜 개발자 연동은 베타·얼리액세스 단계라 경로·필드명·tool 스키마가 정식 출시 전 바뀔 수 있습니다.

> 본 글은 일반 정보 제공용이며 법률 자문이 아닙니다. 전자서명법·전자문서법 등 법령 인용은 표준 참고용이고 전자서명의 효력을 100% 보장하지 않으며, 개별 사안은 전문가 상담을 권장합니다.

더 보기: 개발자·MCP 문서 · API·MCP 연동 안내 · 요금 안내 · 개발자 문서·OpenAPI