DocuSign API: Создание "адаптивного" HTML-документа для мобильной подписи

Шуньфан

2026-03-15

3 мин

Введение в DocuSign API для мобильных подписей

В постоянно меняющемся мире цифровых соглашений предприятия все больше полагаются на платформы электронных подписей для оптимизации рабочих процессов, особенно на мобильных устройствах, где пользователи ожидают бесперебойной работы. API DocuSign выделяется как мощный инструмент, позволяющий разработчикам интегрировать адаптивные функции подписи в приложения. Такой подход не только повышает вовлеченность пользователей, но и обеспечивает соответствие глобальным стандартам, что делает его стратегическим выбором для предприятий, обрабатывающих большие объемы транзакций.

Сравниваете платформы электронных подписей с DocuSign или Adobe Sign?

eSignGlobal предлагает более гибкое и экономичное решение для электронных подписей с глобальным соответствием, прозрачным ценообразованием и более быстрой адаптацией.

👉 Начните бесплатную пробную версию

Создание адаптивных HTML-документов с помощью DocuSign API

С точки зрения бизнеса, оптимизация электронных подписей для мобильных устройств имеет решающее значение, поскольку, согласно отраслевым отчетам, более 50% соглашений в настоящее время подписываются на смартфонах. API DocuSign позволяет разработчикам создавать "адаптивные" HTML-документы, которые адаптируются к различным размерам экранов, обеспечивая беспрепятственный процесс подписания. Это не только снижает количество отказов, но и повышает операционную эффективность отделов продаж, кадров и юридических отделов.

Пошаговое руководство по созданию адаптивного HTML для мобильной подписи

Для начала вам понадобится учетная запись разработчика DocuSign и знакомство с REST API. Процесс включает в себя встраивание церемонии подписания в HTML-конверт, который становится адаптивным с помощью медиа-запросов CSS. Вот как это реализовать:

Настройка конверта DocuSign через API: Начните с аутентификации с помощью OAuth 2.0. Используйте конечную точку Envelopes: create для создания конверта. Укажите документ как HTML-файл, установив параметр documentBase64 в закодированное HTML-содержимое. Для мобильной оптимизации убедитесь, что HTML содержит метатег viewport, например <meta name="viewport" content="width=device-width, initial-scale=1.0">, для управления масштабированием.

Пример вызова API (с использованием cURL для иллюстрации):
```
curl -X POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "emailSubject": "Подпишите этот документ на мобильном устройстве",
  "documents": [{
    "documentBase64": "{base64EncodedHTML}",
    "name": "responsive-agreement.html",
    "fileExtension": "html",
    "documentId": "1"
  }],
  "recipients": {
    "signers": [{
      "email": "signer@example.com",
      "name": "John Doe",
      "recipientId": "1",
      "tabs": {
        "signHereTabs": [{
          "xPosition": "100",
          "yPosition": "100",
          "documentId": "1",
          "pageNumber": "1"
        }]
      }
    }]
  },
  "status": "sent"
}'
```
Это создаст конверт с HTML-документом, готовым к подписанию.
Разработка адаптивной HTML-структуры: Создайте свой HTML, используя подход mobile-first. Используйте гибкие макеты, такие как Flexbox или CSS Grid. Например, структурируйте документ на разделы для текста, полей и областей подписи, которые могут перетекать на небольших экранах. Интегрируйте маркеры привязки DocuSign или текстовые теги для динамического размещения полей — например, {{SigHere1}} для поля подписи.

Пример адаптивного HTML-фрагмента:
```
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <style>
    body { font-family: Arial, sans-serif; margin: 0; padding: 20px; }
    .container { max-width: 100%; margin: 0 auto; }
    @media (max-width: 768px) {
      body { padding: 10px; }
      .signature-field { width: 100%; height: 100px; border: 1px dashed #ccc; }
    }
    @media (min-width: 769px) {
      .signature-field { width: 300px; height: 150px; }
    }
  </style>
</head>
<body>
  <div class="container">
    <h1>Условия соглашения</h1>
    <p>Это адаптивный пункт, который адаптируется к вашему устройству.</p>
    
  </div>
</body>
</html>
```
Закодируйте этот HTML в Base64 перед отправкой в API. Адаптивный CSS гарантирует, что поля, такие как подписи, масштабируются соответствующим образом, избегая проблем с масштабированием на мобильных устройствах.
Встраивание церемонии подписания: Для встроенной подписи используйте конечные точки Rooms: create или Envelopes: createRecipientView для создания URL-адреса подписи. Перенаправьте пользователя на этот URL-адрес в своем приложении. Для улучшения мобильного пользовательского опыта интегрируйте JavaScript для удобного взаимодействия с сенсорным экраном, например, для подписи жестом, если это поддерживается SDK DocuSign.

После создания получите представление получателя:
```
curl -X POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "authenticationMethod": "none",
  "email": "signer@example.com",
  "returnUrl": "https://yourapp.com/return",
  "userId": "signer@example.com"
}'
```
Возвращенный url по умолчанию оптимизирован для мобильных устройств, но ваш адаптивный HTML гарантирует, что сам документ отображается идеально.
Обработка мобильных проблем: Протестируйте на устройствах iOS и Android. Распространенные проблемы включают рендеринг шрифтов и сенсорные цели — сенсорные области должны быть не менее 44x44 пикселей в соответствии с рекомендациями Apple. Если пользовательский HTML слишком сложен, используйте PowerForms DocuSign для предварительно созданных адаптивных шаблонов. Отслеживайте статус конверта с помощью веб-перехватчиков, чтобы отслеживать процент завершения на мобильных устройствах, что позволит принимать бизнес-решения.
Лучшие практики бизнес-интеграции: С коммерческой точки зрения эта настройка подходит для случаев использования с большим объемом, таких как выездные продажи. Ограничьте планы, поддерживающие квоты API (например, Intermediate около 100 конвертов в месяц). Обеспечьте соответствие требованиям, добавив коды доступа или SMS-аутентификацию в качестве дополнительных функций.

Согласно тематическим исследованиям DocuSign, этот подход на основе API может сократить время подписания до 80%, что делает его достойной инвестицией для мобильных предприятий. Разработчикам следует обращаться к официальной документации DocuSign API для получения обновлений, поскольку функциональность постоянно развивается.

Обзор IAM CLM и экосистемы DocuSign

Решения DocuSign для интеллектуального управления соглашениями (IAM) и управления жизненным циклом контрактов (CLM) выходят за рамки базовых электронных подписей, предлагая сквозную автоматизацию контрактов. IAM интегрирует искусственный интеллект для оценки рисков и извлечения условий, а CLM обрабатывает составление, переговоры и анализ. Эти инструменты являются частью планов более высокого уровня, таких как Business Pro (40 долларов США в месяц на пользователя в год), что привлекает предприятия, нуждающиеся в управлении. Полный корпоративный IAM не имеет общедоступных цен, но это индивидуальное решение для отраслей с интенсивным соблюдением нормативных требований.

Конкурентная среда: сравнение платформ электронных подписей

На мировом рынке электронных подписей, стоимость которого превышает 10 миллиардов долларов США, такие платформы, как DocuSign, конкурируют по функциональности, ценам и региональной адаптации. Ниже приведено нейтральное сравнение ключевых игроков с упором на основные аспекты бизнес-оценки.

Платформа	Цены (годовые, доллары США)	Ограничения по пользователям	Ограничения по конвертам	Ключевые функции	Поддержка API	Региональные преимущества
DocuSign	Personal: $120; Standard: $300/пользователь; Business Pro: $480/пользователь; API Starter: $600	Лицензирование по местам	~100/пользователь/год (Standard/Pro)	Массовая отправка, условная логика, IAM CLM, SSO	Мощная (отдельный план)	Глобальная, сильное соответствие требованиям в США/ЕС (ESIGN/eIDAS)
Adobe Sign	От $10/пользователь/месяц (оплачивается ежегодно)	По местам	Неограниченно на более высоких уровнях	Интеграция с экосистемой Adobe, формы, платежи	Мощная через Adobe API	Отлично подходит для творческих/цифровых рабочих процессов, фокус на США/ЕС
eSignGlobal	Essential: $299 (неограниченное количество пользователей); Professional: Индивидуально	Неограниченное количество пользователей	100 конвертов (Essential)	AI-Hub, массовая отправка, интеграция региональных идентификаторов (iAM Smart, Singpass)	Включено в план Pro	Оптимизировано для APAC, глобальное соответствие требованиям в более чем 100 странах
HelloSign (Dropbox Sign)	Бесплатный уровень; Pro: $15/пользователь/месяц	По местам	20/месяц (Pro)	Простой пользовательский интерфейс, шаблоны, совместная работа в команде	Базовый API	Удобно для SMB, ориентировано на США, простая интеграция с Dropbox

Эта таблица подчеркивает компромиссы: DocuSign превосходит по глубине корпоративного уровня, в то время как альтернативы отдают приоритет стоимости или региональной адаптации.

Adobe Sign: сбалансированный корпоративный вариант

Adobe Sign, легко интегрируясь с инструментами PDF и корпоративными пакетами, такими как Microsoft 365, предлагает надежную мобильную подпись с адаптивными формами. Цены начинаются с низкого уровня, но расширяются с добавлением таких функций, как аутентификация. Он подходит для отраслей с интенсивным документооборотом, подчеркивая безопасность в рамках ESIGN и eIDAS.

eSignGlobal: фокус на региональном соответствии

eSignGlobal позиционирует себя как экономичную альтернативу, соответствующую требованиям в более чем 100 основных странах мира, особенно сильную в Азиатско-Тихоокеанском регионе (APAC). Ландшафт электронных подписей в APAC фрагментирован, с высокими стандартами и строгими правилами, требующими решений с интеграцией экосистемы — в отличие от более основанных на фреймворках ESIGN/eIDAS в США и ЕС. Здесь платформы должны обеспечивать глубокую интеграцию на уровне оборудования/API с цифровыми идентификаторами от правительства к бизнесу (G2B), что является техническим препятствием, выходящим далеко за рамки проверки электронной почты или моделей самодекларации, распространенных на западных рынках. План Essential от eSignGlobal, всего за 16,6 долларов США в месяц (ежегодно), позволяет отправлять до 100 документов с электронной подписью, неограниченное количество мест для пользователей и проверку с помощью кодов доступа, обеспечивая надежную ценность на основе соответствия требованиям. Он легко интегрируется с iAM Smart в Гонконге и Singpass в Сингапуре, сокращая задержки и повышая доверие к трансграничным транзакциям.

esignglobal HK

Ищете более умную альтернативу DocuSign?

👉 Начните бесплатную пробную версию

HelloSign (Dropbox Sign): простота для SMB

HelloSign, теперь часть Dropbox, предлагает интуитивно понятный интерфейс для быстрой настройки, обеспечивая надежную мобильную поддержку с помощью адаптивного встраивания. Он экономичен для небольших команд, но ему не хватает расширенной глубины API по сравнению с DocuSign, с упором на простоту использования, а не на настройку.

Региональные правила электронных подписей

Хотя заголовок не указывает регион, понимание законов имеет решающее значение для реализации API. В США ESIGN и UETA обеспечивают широкую применимость электронных записей. eIDAS в ЕС регулирует квалифицированные подписи для большей юридической силы. APAC различается: Закон об электронных транзакциях Сингапура аналогичен ESIGN, но требует локального хранения данных, в то время как Гонконг требует интеграции с такими системами, как iAM Smart, для обеспечения действительности. Предприятия, использующие DocuSign API, должны соответствующим образом настраивать конверты, чтобы избежать проблем с соответствием требованиям.

Заключение

API DocuSign обеспечивает адаптивные мобильные подписи, повышая эффективность в цифровом мире. Для альтернатив рассмотрите eSignGlobal как вариант регионального соответствия, особенно в APAC, балансируя стоимость и глобальный охват. Оцените в соответствии с потребностями вашего бизнеса, чтобы найти оптимальное соответствие.

Шуньфан

Руководитель отдела управления продуктами в eSignGlobal, опытный лидер с обширным международным опытом в индустрии электронных подписей. Подпишитесь на мой LinkedIn