DocuSign API: 특정 폴더 내 모든 템플릿 목록을 가져오는 방법

DocuSign 템플릿 및 API 소개

디지털 문서 관리의 끊임없이 진화하는 환경에서 DocuSign은 전 세계 기업의 워크플로를 간소화하는 선도적인 전자 서명 플랫폼으로 두각을 나타냅니다. 템플릿은 DocuSign에서 중요한 역할을 하며, 사용자가 반복 사용을 위해 문서를 표준화하여 시간을 절약하고 계약 승인 또는 온보딩과 같은 프로세스의 일관성을 보장할 수 있도록 합니다. DocuSign API를 통해 개발자는 이러한 작업을 프로그래밍 방식으로 자동화하여 전자 서명 기능을 사용자 지정 애플리케이션에 쉽게 통합할 수 있습니다. 이 문서에서는 기업 환경에서 효율적인 템플릿 관리에 대한 일반적인 요구 사항인 특정 폴더에서 모든 템플릿 목록을 검색하기 위해 DocuSign API를 활용하는 방법을 살펴봅니다.

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

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

👉 무료 평가판 시작

DocuSign 템플릿 이해

DocuSign 템플릿은 미리 정의된 필드, 서명자 역할 및 워크플로가 포함된 미리 구성된 문서입니다. 템플릿은 DocuSign 계정에서 폴더로 구성되어 사용자가 부서, 프로젝트 또는 유형별로 분류할 수 있습니다. 예를 들어 HR 템플릿은 한 폴더에, 판매 계약은 다른 폴더에 넣을 수 있습니다. 이러한 구성은 많은 양의 문서를 처리하는 팀에게 매우 중요합니다. 혼란을 방지하고 빠른 액세스를 용이하게 하기 때문입니다.

비즈니스 관점에서 템플릿은 오류를 줄이고 서명 프로세스를 가속화할 수 있습니다. 예를 들어 영업팀은 매번 필드를 다시 만들 필요 없이 제안서 템플릿을 재사용하여 브랜드 일관성과 규정 준수를 보장할 수 있습니다. 그러나 수백 개의 템플릿이 있는 대규모 계정의 경우 폴더를 수동으로 탐색하는 것은 비효율적일 수 있습니다. 바로 이 지점에서 DocuSign API가 등장하여 템플릿을 쿼리하고 나열하는 프로그래밍 방식을 제공합니다.

DocuSign API 시작하기

DocuSign API를 사용하려면 개발자는 활성 DocuSign 계정과 API 자격 증명이 필요합니다. DocuSign은 프로덕션 기능을 미러링하는 테스트를 위한 무료 샌드박스 환경을 제공합니다. 인증에는 일반적으로 OAuth 2.0이 포함되며 DocuSign 개발자 센터에서 통합 키(클라이언트 ID)와 비밀 키를 생성할 수 있습니다.

템플릿의 주요 엔드포인트는 eSignature API 아래, 특히 /accounts/{accountId}/templates 리소스에 있습니다. /accounts 엔드포인트를 통해 얻을 수 있는 계정 ID가 필요합니다. DocuSign의 폴더는 고유한 폴더 ID로 식별되며, 이러한 ID는 /folders 엔드포인트를 사용하여 검색할 수 있습니다. 이러한 설정은 템플릿 데이터에 대한 안전하고 확장 가능한 액세스를 보장합니다.

DocuSign의 API 문서는 포괄적이며 Java, .NET, PHP 및 Python과 같은 언어에 대한 SDK를 지원하여 통합을 간소화합니다. 기업의 경우 이는 전자 서명을 Salesforce와 같은 CRM 시스템 또는 사용자 지정 애플리케이션에 임베드하여 도구를 전환할 필요 없이 운영 효율성을 높일 수 있음을 의미합니다.

DocuSign API를 사용하여 특정 폴더에서 템플릿을 검색하는 방법

DocuSign REST API를 사용하여 특정 폴더에서 템플릿 목록을 검색하는 것은 간단한 프로세스입니다. 이 기능은 템플릿 옵션을 동적으로 채우거나 폴더 내용을 감사해야 하는 애플리케이션에 특히 유용합니다. 핵심 엔드포인트는 GET /accounts/{accountId}/folders/{folderId}/templates이며, 지정된 폴더에 있는 템플릿의 페이지 매김된 목록을 반환합니다.

전제 조건

코드를 자세히 살펴보기 전에 다음 사항을 확인하십시오.

• OAuth 2.0 액세스 토큰이 있습니다.
• 계정 ID와 폴더 ID를 알고 있습니다. 폴더 ID를 얻으려면 먼저 GET /accounts/{accountId}/folders를 호출하여 모든 폴더를 나열하고 필요한 폴더를 식별합니다(예: 이름 또는 공유 상태별).
• 권한: API 사용자는 템플릿 읽기 액세스 권한이 있어야 합니다.

단계별 구현

1. 인증 및 토큰 가져오기: OAuth 흐름을 사용하여 액세스 토큰을 가져옵니다. 예를 들어 Python에서 DocuSign eSignature SDK를 사용합니다.

   import docusign_esign as ds_esign
   
   # API 클라이언트 구성
   api_client = ds_esign.ApiClient()
   api_client.host = 'https://demo.docusign.net/restapi'  # 테스트 시 데모 사용
   api_client.set_default_header('Authorization', 'Bearer ' + access_token)
   

2. 폴더 ID 검색: 폴더 ID를 모르는 경우 폴더를 나열합니다.

   envelopes_api = ds_esign.EnvelopesApi(api_client)
   folders = envelopes_api.list_folders(account_id)
   # 반복하여 이름별로 폴더를 찾습니다. 예: folder_id = next(f['folderId'] for f in folders if f['folderName'] == 'My Templates Folder')
   

3. 폴더에서 템플릿 나열: Templates API를 사용하여 템플릿을 가져옵니다.

   templates_api = ds_esign.TemplatesApi(api_client)
   template_list = templates_api.list_templates(account_id, folder=folder_id, count=100)  # 페이지 매김을 위해 count 조정
   for template in template_list.envelopes:
       print(f"Template Name: {template.name}, ID: {template.template_id}")
   

   그러면 템플릿 이름, ID, 공유 상태 및 마지막 수정 날짜와 같은 세부 정보가 반환됩니다. 응답은 템플릿 요약의 envelopes 배열이 포함된 JSON 형식입니다.

4. 페이지 매김 및 오류 처리: 폴더에 지정된 수(기본값 20, 최대 100)보다 많은 템플릿이 있는 경우 start_position 쿼리 매개변수를 사용하여 후속 페이지를 가져옵니다. 일반적인 오류에는 401(권한 없음) 또는 404(폴더를 찾을 수 없음)가 포함됩니다. 항상 오류 처리를 포함하십시오.

   try:
       template_list = templates_api.list_templates(account_id, folder=folder_id)
   except ds_esign.ApiException as e:
       print(f"Error: {e.body}")
   

5. 고급 필터링: search_text와 같은 쿼리 매개변수를 추가하여 이름별로 필터링하거나 include를 추가하여 공유 템플릿을 포함합니다. 기업 사용자의 경우 이는 템플릿 변경 시 실시간 업데이트를 위해 웹후크와 잘 통합됩니다.

이 API 호출은 일반적으로 밀리초 단위로 걸리므로 사용자가 폴더 템플릿 드롭다운 목록에서 선택하는 UI 기반 애플리케이션에 적합합니다. 기업 보고서에 따르면 템플릿 검색을 자동화하여 문서 준비 시간을 최대 50%까지 절약할 수 있습니다.

사용 사례 예

법률 회사가 DocuSign을 사건 관리 시스템과 통합한다고 상상해 보십시오. API는 “Contracts” 폴더에서 템플릿을 가져와 사건 유형에 따라 자동으로 채워 규정 준수와 속도를 보장합니다.

API를 통한 템플릿 관리 모범 사례

이 API 기능을 구현할 때는 보안을 우선시하고 JWT 또는 권한 부여 코드 권한 부여를 사용하여 토큰을 가져오고 정기적으로 교체하십시오. 속도 제한을 피하기 위해 API 호출을 제한하는 데 캐싱을 사용하십시오(예: 프로덕션 환경에서 시간당 1,000회 호출). 확장성을 위해 DocuSign의 Connect 웹후크를 사용하여 폴링할 필요 없이 새 템플릿에 대한 애플리케이션에 알립니다.

API 대시보드를 통해 사용량을 모니터링하여 봉투 할당량을 추적합니다. 템플릿은 Business Pro와 같은 계획에서 전체 제한에 포함되기 때문입니다. 샌드박스에서 테스트하면 프로덕션 중단을 방지할 수 있습니다.

경쟁업체와 DocuSign 비교

DocuSign은 원활한 API 통합과 글로벌 규정 준수를 제공하는 강력한 전자 서명 플랫폼입니다. 템플릿 관리는 구조화된 환경에서 탁월하지만 가격은 사용자 및 기능에 따라 확장됩니다.

Adobe Document Cloud의 일부인 Adobe Sign은 PDF 편집과 같은 Adobe 에코시스템과의 강력한 통합을 제공합니다. 크리에이티브 팀에 적합하지만 고급 API를 사용하려면 추가 라이선스가 필요할 수 있습니다.

eSignGlobal은 특히 아시아 태평양(APAC) 지역에서 경쟁력 있는 대안으로 두각을 나타냅니다. APAC의 파편화된 규제 환경에 특별한 중점을 두고 전 세계 100개 주요 국가의 규정 준수를 지원합니다. 미국(ESIGN) 또는 유럽(eIDAS)의 프레임워크 기반 표준과 달리 이메일 확인 또는 자체 선언에 의존하는 APAC 규정은 정부 디지털 ID(G2B)와의 심층적인 하드웨어 및 API 수준 통합을 통해 에코시스템 통합 솔루션을 요구합니다. 여기에는 높은 표준과 엄격한 감독이 포함되어 기술 장벽을 서구 모델보다 훨씬 높게 만듭니다. eSignGlobal은 이 분야에서 탁월하며 홍콩 iAM Smart 및 싱가포르 Singpass와의 원활한 통합을 제공하는 동시에 무제한 사용자 및 비용 효율적인 가격 책정을 제공합니다. Essential 요금제는 월 16.6달러에 불과하며 최대 100개의 전자 서명 문서, 무제한 사용자 시트를 보내고 액세스 코드 확인을 통해 규정 준수 기반으로 높은 가치를 제공합니다. 이를 통해 eSignGlobal은 일반적으로 더 낮은 비용으로 DocuSign 및 Adobe Sign과 전 세계적으로 경쟁할 수 있습니다.

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

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

👉 무료 평가판 시작

HelloSign(현재 Dropbox Sign)은 단순성에 중점을 두고 직관적인 템플릿과 소규모 팀에 적합한 API 액세스를 제공합니다. 기본 요구 사항에 대한 비용 효율적이지만 일부 엔터프라이즈급 기능이 부족합니다.

이 표는 중립적인 절충안을 강조합니다. DocuSign은 규모에, Adobe는 통합에, eSignGlobal은 지역 가치에, HelloSign은 사용 편의성에 적합합니다.

결론

템플릿 관리를 위해 DocuSign의 API를 탐색하면 특히 특정 폴더 쿼리의 경우 생산성을 크게 높일 수 있습니다. 대안을 찾는 기업의 경우 eSignGlobal은 APAC 및 더 넓은 지역에서 견고하고 지역 규정을 준수하는 옵션을 제공합니다.