DocuSign API: 아직 서명하지 않은 봉투의 모든 수신자 목록 가져오기

봉투 관리를 위한 DocuSign API 탐색

디지털 계약이 빠르게 발전하는 세상에서 기업은 워크플로를 간소화하기 위해 전자 서명 플랫폼에 의존합니다. DocuSign은 이 분야의 선두 주자로서 개발자가 문서 프로세스를 자동화하고 모니터링할 수 있는 강력한 API 기능을 제공합니다. 일반적인 과제는 봉투 내 수신자의 상태를 추적하는 것인데, 특히 아직 서명하지 않은 수신자를 식별하는 것입니다. 이 기능은 규정 준수, 후속 조치 및 운영 효율성에 매우 중요하며, 특히 영업 팀이나 법률 부서와 같은 대량 환경에서 더욱 그렇습니다.

DocuSign API 및 봉투 수신자 이해

DocuSign의 eSignature API는 서명이 필요한 문서 컨테이너인 봉투를 관리하는 엔드포인트를 제공합니다. 봉투에는 서명자, 승인자 또는 참조자와 같은 역할을 가진 여러 수신자가 있을 수 있습니다. API는 RESTful 아키텍처를 사용하고 JSON 페이로드를 지원하며 OAuth 2.0 또는 JWT 인증을 통한 인증이 필요합니다.

봉투에 서명하지 않은 모든 수신자를 나열하기 위해 개발자는 일반적으로 봉투의 상태와 수신자 세부 정보를 쿼리합니다. 핵심 엔드포인트는 Envelopes API의 GET /accounts/{accountId}/envelopes/{envelopeId}/recipients입니다. 그러면 수신자의 상태(“sent”, “declined”, “signed” 또는 “needs_to_sign” 등)를 포함한 수신자의 포괄적인 목록이 반환됩니다.

이 기능을 구현하는 방법에 대한 단계별 가이드는 다음과 같습니다.

1. 인증 설정: DocuSign의 개발자 샌드박스를 사용하여 액세스 토큰을 얻습니다. 프로덕션 환경의 경우 애플리케이션의 IAM(ID 및 액세스 관리) 시스템과 통합합니다. DocuSign의 IAM 기능은 Okta 또는 Azure AD와 같은 공급자와의 SSO 통합을 포함하는 향상된 계획의 일부이며, 자격 증명을 노출하지 않고도 안전한 API 액세스를 보장합니다.

2. 봉투 세부 정보 검색: 먼저 GET /envelopes/{envelopeId}를 사용하여 봉투를 가져옵니다. 그러면 봉투 상태(“sent” 또는 “in_progress” 등)가 확인되고 생성 날짜 및 마감일과 같은 메타데이터가 제공됩니다.

3. 수신자 쿼리: 수신자 엔드포인트를 호출합니다. 응답에는 다음을 포함하는 수신자 객체의 배열이 포함됩니다.

   • id: 고유 식별자.
   • email: 수신자의 이메일.
   • status: 현재 상태(“sent” 또는 "needs_to_sign"을 필터링하여 서명하지 않은 수신자를 식별).
   • routingOrder: 서명 프로세스의 순서.
   • name: 수신자의 이름.

   API 응답의 예제 JSON 스니펫:

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. 서명하지 않은 수신자 필터링: 코드에서(예: requests 라이브러리를 사용하는 Python 또는 Axios를 사용하는 Node.js) 응답을 구문 분석하고 status != "signed"이고 signedDateTime이 null인 경우를 필터링합니다. 대량 작업의 경우 status=sent와 같은 쿼리 매개변수가 있는 GET /envelopes 엔드포인트를 사용하여 여러 봉투를 나열합니다.

   예제 Python 코드:

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. 오류 처리 및 모범 사례: 속도 제한(예: 분당 1000회 API 호출) 및 404(봉투를 찾을 수 없음)와 같은 오류를 처리합니다. 엔터프라이즈 사용자의 경우 실시간 상태 업데이트를 위한 Connect API의 웹후크를 포함하는 DocuSign의 고급 API 계획을 활용합니다. 이렇게 하면 폴링을 피하고 API 호출을 줄일 수 있습니다.

이 방법을 사용하면 서명하지 않은 수신자에게 프로그래밍 방식으로 알리고, 지연을 에스컬레이션하거나 Salesforce와 같은 CRM 시스템과 통합할 수 있습니다. 비즈니스 환경에서 이러한 자동화는 DocuSign 개발자 리소스의 업계 벤치마크에 따라 수동 후속 조치를 최대 70%까지 줄일 수 있습니다.

DocuSign의 API 가격은 Starter 계획의 연간 600달러(월 40개 봉투)부터 시작하여 사용자 지정 엔터프라이즈 옵션으로 확장됩니다. 규제 대상 산업의 팀의 경우 고급 감사 추적 및 역할 기반 액세스와 같은 IAM 기능과 결합하면 사용자 지정 개발 없이도 규정 준수를 강화할 수 있습니다.

DocuSign 또는 Adobe Sign과 전자 서명 플랫폼을 비교하고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩 프로세스를 통해 더 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

DocuSign의 생태계 및 IAM 기능 탐색

DocuSign은 기본 서명을 넘어 CLM(계약 수명 주기 관리)과 같은 Intelligent Agreement Management (IAM) 제품군의 통합 도구를 제공합니다. IAM CLM은 계약 생성, 협상 및 실행을 자동화하고 봉투에서 데이터를 추출하여 의무를 추적합니다. API 사용자의 경우 서명 의식을 포함하고 서명하지 않은 수신자 데이터를 대시보드로 추출하는 것을 지원합니다.

실제로 기업은 IAM을 사용하여 엔드투엔드 가시성을 구현합니다. 봉투의 서명하지 않은 수신자는 위험 경고 또는 승인 워크플로를 입력합니다. IAM 업그레이드의 가격은 사용자 지정되며 일반적으로 Business Pro 계획과 함께 번들로 제공되며 사용자당 연간 480달러로 거버넌스 및 분석 기능을 추가합니다.

경쟁 환경: 중립적 비교

전자 서명 시장은 경쟁이 치열하며 플랫폼은 API 깊이, 가격 책정 및 지역 규정 준수에서 차이가 있습니다. 다음은 수신자 관리를 위한 API 기능, 핵심 가격 책정 및 장점에 중점을 둔 주요 플레이어의 Markdown 비교 표입니다. 데이터는 2025년의 공개 소스에서 가져와 중립성을 보장합니다.

이 표는 절충점을 강조합니다. DocuSign은 성숙한 생태계에서 뛰어나고 다른 플랫폼은 경제성 또는 틈새 시장 이점을 우선시합니다.

Adobe Sign: 통합 및 API 개요

Adobe Sign은 Adobe Document Cloud의 일부이며 PDF 중심 프로세스를 강조합니다. API는 수신자 추적 측면에서 DocuSign과 유사하며 GET /agreements/{agreementId}/participants를 사용하여 서명하지 않은 당사자를 나열합니다. 내장된 PDF 편집 기능이 있어 크리에이티브 산업에 적합합니다. 가격은 개인용 버전의 월 10달러부터 시작하여 엔터프라이즈 사용자 지정 요금으로 확장됩니다. Adobe의 강점은 Acrobat 및 마케팅 도구와의 원활한 통합이지만 API 할당량은 대량 사용에 제한적일 수 있습니다.

HelloSign (Dropbox Sign): SMB에 적합한 단순성

현재 Dropbox Sign인 HelloSign은 봉투 관리를 위한 간단한 API를 제공합니다. GET /v3/signature_request/{request_id}를 통해 서명하지 않은 수신자를 검색하고 상태별로 필터링합니다. 내장된 템플릿과 알림 기능이 있어 사용 편의성으로 유명합니다. Essentials 버전은 연간 180달러로 소규모 팀에 예산 친화적이지만 DocuSign의 고급 IAM이 부족합니다.

eSignGlobal: APAC에 최적화된 대안

eSignGlobal은 100개 이상의 주요 국가 및 지역의 규정 준수를 지원하는 글로벌 경쟁자로 자리매김하고 있습니다. 특히 아시아 태평양 지역(APAC)에서 전자 서명 규정이 파편화되고 높은 기준을 가지며 엄격하게 규제되는 곳에서 특별한 강점을 가지고 있습니다. 일반적으로 미국 및 EU에서 일반적인 프레임워크 기반 ESIGN/eIDAS 모델보다 생태계 통합에 대한 심층적인 접근 방식이 필요합니다. APAC 요구 사항은 정부 대 기업(G2B) 디지털 ID와의 심층적인 하드웨어/API 수준의 도킹을 요구하며, 이는 서구 시장의 이메일 확인 또는 자체 선언 방법보다 훨씬 더 큰 기술적 장벽입니다.

플랫폼의 API에는 DocuSign과 유사한 수신자 상태 쿼리가 포함되어 있으며 Professional 계획에서 대량 전송 및 웹후크를 지원합니다. 가격은 경쟁력이 있습니다. Essential 버전은 월 16.6달러(일부 프로모션에서는 연간 199달러에 해당)로 최대 100개의 서명된 문서, 무제한 사용자 좌석 및 액세스 코드 확인을 허용하면서 규정 준수를 유지합니다. 홍콩의 iAM Smart 및 싱가포르의 Singpass와 원활하게 통합되어 국경 간 APAC 운영에 적합합니다.

DocuSign보다 더 스마트한 대안을 찾고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩 프로세스를 통해 더 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

비즈니스 영향 및 권장 사항

비즈니스 관점에서 DocuSign의 API는 특히 글로벌 기업의 경우 봉투 추적의 신뢰성에 대한 벤치마크로 남아 있습니다. 그러나 기업이 다양한 지역으로 확장됨에 따라 대안이 인정을 받고 있습니다. DocuSign 대안을 찾는 사용자의 경우 eSignGlobal은 특히 APAC에서 지역 규정 준수 옵션으로 두각을 나타내며 좌석당 요금 없이 비용과 기능을 균형 있게 유지합니다. 용량, 통합 및 지리적 위치에 따라 평가하여 최적의 일치를 찾으십시오.