API 도입 시나리오
모두싸인 API를 실제로 도입한 고객사들의 연동 방식을 상황별로 정리했습니다. 우리 회사 상황과 비슷한 시나리오를 찾아 어떤 흐름으로 연동하고 어떤 API를 쓰는지 확인해 보세요. 이 문서에서 '우리 서비스'는 모두싸인 API를 연동하는 여러분의 웹사이트·앱·관리자 화면·사내 시스템을 가리킵니다.
이 문서를 읽는 방법아래 '나에게 맞는 시나리오 찾기'에서 상황에 맞는 시나리오를 고른 뒤 해당 문서로 이동하세요. 시나리오는 서로 조합할 수 있습니다. 예를 들어 사내 시스템에서 계약서를 보내고(시나리오 4), 거래처가 먼저 서명한 뒤 회사가 마지막에 서명하고(시나리오 6), 완료 문서를 사내 시스템에 저장하는(시나리오 7) 방식이 흔히 함께 쓰입니다.
나에게 맞는 시나리오 찾기
질문에 답하면 우리 회사에 맞는 시나리오를 추천해 드립니다.
서명자는 어디서 서명하나요?
전체 시나리오는 아래 표에서도 확인할 수 있습니다.
| 이런 상황이라면 | 추천 시나리오 |
|---|---|
| 회원가입·결제·신청처럼 고객이 무언가를 하면, 사람 손을 거치지 않고 계약서를 자동으로 보내고 싶다 | 1. 가입·결제 후 계약서 자동 전송 |
| 카카오톡·이메일로 보내지 않고, 우리 서비스 화면 안에서 바로 서명받고 싶다 | 2. 우리 서비스 화면 안에서 서명 |
| 영업 담당자나 상담사가 현장에서 태블릿으로 서명받고 싶다 | 3. 현장 태블릿 서명 |
| 직원이 결재·협의를 마친 계약을, 사내 시스템에 모두싸인 서명 요청 화면을 띄워 확인하고 보내고 싶다 | 4. 사내 시스템에서 확인 후 전송 |
| 계약서마다 조항과 길이가 달라 템플릿으로 만들기 어렵고, 서명 자리를 자동으로 잡아 보내고 싶다 | 5. 계약서마다 서명 자리 자동 배치 |
| 상대방이 먼저 서명하고 회사가 마지막에 서명하거나, 미성년자와 법정대리인처럼 여러 명이 서명해야 한다 | 6. 여러 명 순서대로 서명 |
| 서명 요청은 모두싸인 웹에서 그대로 하고, 완료된 문서와 입력값만 우리 서비스에 자동으로 저장하고 싶다 | 7. 완료 문서 자동 저장 |
| 우리 서비스를 쓰는 담당자가 모두싸인에 따로 접속하지 않고 템플릿을 만들고 고치게 하고 싶다 | 8. 우리 서비스에서 템플릿 관리 |
모든 시나리오는 서명자에게 서명 요청을 어떻게 전달할지 정하는 데서 시작합니다. 이메일·카카오톡 같은 전송 수단으로 보내거나, 전송하지 않고 우리 서비스 화면에서 임베디드 보안 링크로 서명 화면을 직접 열 수 있습니다. 서명자마다 다르게 정할 수 있으며, API에서는 서명자의 signingMethod.type 값으로 지정합니다.
| 전달 방법 | 값 | 이런 경우에 씁니다 |
|---|---|---|
| 이메일 | EMAIL | 거래처 담당자처럼 이메일로 문서를 받는 것이 익숙한 서명자에게 보낼 때 |
| 카카오톡 | KAKAO | 개인 고객·임직원처럼 휴대폰으로 바로 확인하는 서명자에게 보낼 때 |
| 임베디드 보안 링크 | SECURE_LINK | 모두싸인이 알림을 보내지 않고, 우리 서비스 화면이나 현장 태블릿에서 서명 화면을 직접 열어 줄 때 |
임베디드 보안 링크는 연락처 확인을 하지 않습니다이메일과 카카오톡은 서명자의 연락처로 링크를 보내기 때문에 그 연락처를 가진 사람이 서명했다는 것을 확인할 수 있습니다. 임베디드 보안 링크는 링크를 보내지 않으므로 이 확인이 없습니다. 서명자 본인 확인이 중요한 계약이라면 우리 서비스의 로그인·본인 확인을 거친 뒤 서명 화면을 열어 주세요.
도입 전에 상담이 필요한 경우
아래 경우는 회사마다 알맞은 구성이 달라, 개발을 시작하기 전에 모두싸인과 연동 구조를 함께 정하는 것을 권장합니다. 모두싸인에 문의하기에서 상담을 요청해 주세요.
| 상황 | 미리 정해야 하는 것 |
|---|---|
| 우리 솔루션에 전자계약을 넣어 다른 회사에 제공하려는 경우 | 계정과 API Key를 우리 회사 하나로 쓸지, 고객사마다 나눌지, OAuth 연동을 쓸지 |
| 여러 지점·계열사가 함께 쓰는 경우 | 계정과 API Key를 어떻게 나누고, 문서를 메타데이터로 어떻게 구분할지 |
| 특정 기간에 대량으로 전송하는 경우 | API Rate Limit 정책에 맞춘 전송 속도와 재시도 방법 |
| 방화벽·폐쇄망 등 외부 통신이 제한된 환경 | 모두싸인 API 호출과 웹훅 수신이 가능한 네트워크 구성 |
| 공공기관 | 공공용 API 사용 여부 |
Updated 38 minutes ago