DocuSign API: Erstellung von "responsiven" HTML-Dokumenten für mobile Signaturen

Shunfang

2026-03-12

3min

Einführung in die DocuSign API für mobile Signaturen

In der sich ständig weiterentwickelnden Landschaft digitaler Vereinbarungen verlassen sich Unternehmen zunehmend auf elektronische Signaturplattformen, um Arbeitsabläufe zu rationalisieren, insbesondere auf mobilen Geräten, wo Benutzer nahtlose Erlebnisse erwarten. Die API von DocuSign erweist sich als leistungsstarkes Tool, mit dem Entwickler reaktionsfähige Signaturfunktionen in Anwendungen integrieren können. Dieser Ansatz verbessert nicht nur die Benutzerinteraktion, sondern gewährleistet auch die Einhaltung globaler Standards, was ihn zu einer strategischen Wahl für Unternehmen macht, die Transaktionen mit hohem Volumen abwickeln.

Vergleichen Sie E-Signatur-Plattformen mit DocuSign oder Adobe Sign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und schnellerem Onboarding.

👉 Starten Sie eine kostenlose Testversion

Erstellen von reaktionsfähigen HTML-Dokumenten mit der DocuSign API

Aus geschäftlicher Sicht ist die Optimierung elektronischer Signaturen für mobile Geräte von entscheidender Bedeutung, da laut Branchenberichten derzeit über 50 % der Vereinbarungen auf Smartphones unterzeichnet werden. Die API von DocuSign ermöglicht es Entwicklern, "reaktionsfähige" HTML-Dokumente zu erstellen, die sich an verschiedene Bildschirmgrößen anpassen und einen reibungslosen Signaturprozess gewährleisten. Dies reduziert nicht nur die Abbruchrate, sondern steigert auch die betriebliche Effizienz von Vertriebs-, Personal- und Rechtsteams.

Schritt-für-Schritt-Anleitung zum Erstellen von reaktionsfähigem HTML für mobile Signaturen

Um zu beginnen, benötigen Sie ein DocuSign-Entwicklerkonto und Kenntnisse der REST-API. Der Prozess umfasst das Einbetten einer Signaturzeremonie in einen HTML-Umschlag, der mit CSS-Media-Queries reaktionsfähig gemacht wird. Hier ist, wie Sie es implementieren:

Richten Sie Ihren DocuSign-Umschlag über die API ein: Beginnen Sie mit der Authentifizierung über OAuth 2.0. Verwenden Sie den Endpunkt Envelopes: create, um einen Umschlag zu generieren. Geben Sie das Dokument als HTML-Datei an, indem Sie den Parameter documentBase64 auf Ihren codierten HTML-Inhalt setzen. Stellen Sie für die mobile Optimierung sicher, dass das HTML ein Viewport-Meta-Tag wie <meta name="viewport" content="width=device-width, initial-scale=1.0"> enthält, um die Skalierung zu steuern.

Beispiel-API-Aufruf (zur Veranschaulichung mit 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": "Sign this document on mobile",
  "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"
}'

Dadurch wird ein Umschlag mit einem HTML-Dokument erstellt, das zur Unterzeichnung bereit ist.

Entwerfen Sie eine reaktionsfähige HTML-Struktur: Erstellen Sie Ihr HTML mit einem Mobile-First-Design. Verwenden Sie flexible Layouts wie Flexbox oder CSS Grid. Strukturieren Sie das Dokument beispielsweise in Abschnitte für Text, Felder und Signaturbereiche, die auf kleineren Bildschirmen neu angeordnet werden können. Integrieren Sie die Anker-Tags oder Text-Tags von DocuSign für die dynamische Feldplatzierung – z. B. {{SigHere1}} für ein Signaturfeld.

Beispiel für ein reaktionsfähiges HTML-Snippet:
```
<!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>Agreement Terms</h1>
    <p>This is a responsive clause that adapts to your device.</p>
    
  </div>
</body>
</html>
```
Codieren Sie dieses HTML in Base64, bevor Sie es an die API senden. Reaktionsfähiges CSS stellt sicher, dass Felder wie Signaturen angemessen skaliert werden, wodurch Skalierungsprobleme auf Mobilgeräten vermieden werden.
Betten Sie die Signaturzeremonie ein: Verwenden Sie für eingebettete Signaturen die Endpunkte Rooms: create oder Envelopes: createRecipientView, um eine Signatur-URL zu generieren. Leiten Sie den Benutzer in Ihrer App zu dieser URL weiter. Um die mobile Benutzererfahrung zu verbessern, integrieren Sie JavaScript für eine berührungsfreundliche Interaktion, z. B. zum Wischen zum Signieren, falls das SDK von DocuSign dies unterstützt.

Rufen Sie nach der Erstellung die Empfängeransicht ab:
```
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"
}'
```
Die zurückgegebene url ist standardmäßig für Mobilgeräte optimiert, aber Ihr reaktionsfähiges HTML-Design stellt sicher, dass das Dokument selbst perfekt gerendert wird.
Behandeln Sie mobile Besonderheiten: Testen Sie auf iOS- und Android-Geräten. Häufige Probleme sind das Rendern von Schriftarten und Berührungsziele – Berührungsbereiche sollten gemäß den Apple-Richtlinien mindestens 44 x 44 Pixel groß sein. Verwenden Sie die PowerForms von DocuSign für vorgefertigte reaktionsfähige Vorlagen, wenn benutzerdefiniertes HTML zu komplex ist. Überwachen Sie den Umschlagstatus über Webhooks, um die mobile Abschlussrate zu verfolgen und so Geschäftsentscheidungen zu treffen.
Best Practices für die Geschäftsintegration: Aus kommerzieller Sicht eignet sich diese Einrichtung für Anwendungsfälle mit hohem Volumen wie den Außendienst. Beschränken Sie sich auf Pläne, die API-Kontingente unterstützen (z. B. Intermediate mit etwa 100 Umschlägen pro Monat). Stellen Sie die Compliance sicher, indem Sie Zugriffscodes oder SMS-Authentifizierung als zusätzliche Funktionen hinzufügen.

Laut Fallstudien von DocuSign kann dieser API-gesteuerte Ansatz die Signaturzeit um bis zu 80 % verkürzen, was ihn zu einer lohnenden Investition für mobilzentrierte Unternehmen macht. Entwickler sollten die offizielle DocuSign-API-Dokumentation für Aktualisierungen konsultieren, da sich die Funktionen ständig weiterentwickeln.

Überblick über IAM CLM und das Ökosystem von DocuSign

Die Lösungen für intelligentes Vereinbarungsmanagement (IAM) und Vertragslebenszyklusmanagement (CLM) von DocuSign gehen über die grundlegende elektronische Signatur hinaus und bieten eine End-to-End-Vertragsautomatisierung. IAM integriert KI für Risikobewertung und Klauselentnahme, während CLM Entwurf, Verhandlung und Analyse abwickelt. Diese Tools sind Teil höherwertiger Pläne wie Business Pro (40 USD/Benutzer/Monat jährlich) und richten sich an Unternehmen, die Governance benötigen. Für das vollständige Enterprise IAM gibt es keine öffentliche Preisgestaltung, aber es handelt sich um eine maßgeschneiderte Lösung für stark regulierte Branchen.

Wettbewerbslandschaft: Vergleich von E-Signatur-Plattformen

Auf dem globalen E-Signatur-Markt mit einem Wert von über 10 Milliarden US-Dollar konkurrieren Plattformen wie DocuSign in Bezug auf Funktionen, Preisgestaltung und regionale Anpassungsfähigkeit. Hier ist ein neutraler Vergleich der wichtigsten Akteure, der sich auf die Kernaspekte der Geschäftsbewertung konzentriert.

Plattform	Preisgestaltung (jährlich, USD)	Benutzerbeschränkungen	Umschlagbeschränkungen	Hauptfunktionen	API-Unterstützung	Regionale Stärken
DocuSign	Personal: 120 USD; Standard: 300 USD/Benutzer; Business Pro: 480 USD/Benutzer; API Starter: 600 USD	Lizenz pro Arbeitsplatz	~100/Benutzer/Jahr (Standard/Pro)	Massenversand, bedingte Logik, IAM CLM, SSO	Robust (separater Plan)	Global, starke US/EU-Compliance (ESIGN/eIDAS)
Adobe Sign	Ab 10 USD/Benutzer/Monat (jährliche Abrechnung)	Pro Arbeitsplatz	Unbegrenzt in höheren Stufen	Integration mit Adobe-Ökosystem, Formulare, Zahlungen	Robust über Adobe API	Hervorragend für kreative/digitale Workflows, US/EU-Fokus
eSignGlobal	Essential: 299 USD (unbegrenzte Benutzer); Professional: Benutzerdefiniert	Unbegrenzte Benutzer	100 Umschläge (Essential)	AI-Hub, Massenversand, regionale ID-Integration (iAM Smart, Singpass)	In Pro-Plan enthalten	APAC-optimiert, globale Compliance in über 100 Ländern
HelloSign (Dropbox Sign)	Kostenlose Stufe; Pro: 15 USD/Benutzer/Monat	Pro Arbeitsplatz	20/Monat (Pro)	Einfache Benutzeroberfläche, Vorlagen, Teamzusammenarbeit	Grundlegende API	SMB-benutzerfreundlich, US-zentriert, einfache Dropbox-Integration

Diese Tabelle verdeutlicht die Kompromisse: DocuSign zeichnet sich durch Unternehmenstiefe aus, während Alternativen Kosten oder regionale Anpassungsfähigkeit priorisieren.

Adobe Sign: Eine ausgewogene Unternehmensoption

Adobe Sign lässt sich nahtlos in PDF-Tools und Unternehmenssuiten wie Microsoft 365 integrieren und bietet robuste mobile Signaturen mit reaktionsfähigen Formularen. Die Preisgestaltung beginnt niedrig, steigt aber mit zusätzlichen Funktionen wie der Authentifizierung. Es eignet sich für dokumentintensive Branchen und betont die Sicherheit im Rahmen von ESIGN- und eIDAS-Frameworks.

eSignGlobal: Regionaler Compliance-Fokus

eSignGlobal positioniert sich als kostengünstige Alternative mit globaler Compliance in über 100 wichtigen Ländern, insbesondere mit Stärken im asiatisch-pazifischen Raum (APAC). Die E-Signatur-Landschaft in APAC ist fragmentiert, mit hohen Standards und strengen Vorschriften, die Lösungen erfordern, die in Ökosysteme integriert sind – im Gegensatz zu den eher frameworkbasierten ESIGN/eIDAS in den USA und der EU. Hier müssen Plattformen eine tiefe Hardware-/API-Integration mit digitalen Government-to-Business (G2B)-Identitäten erreichen, eine technische Hürde, die weit über die in westlichen Märkten üblichen E-Mail-Verifizierungs- oder Selbsterklärungsmodelle hinausgeht. Der Essential-Plan von eSignGlobal kostet nur 16,6 USD/Monat (jährlich), ermöglicht das Versenden von bis zu 100 elektronisch signierten Dokumenten, unbegrenzte Benutzerlizenzen und bietet über die Zugriffscode-Verifizierung einen starken Mehrwert auf Compliance-Basis. Es lässt sich nahtlos in iAM Smart in Hongkong und Singpass in Singapur integrieren, wodurch Verzögerungen reduziert und das Vertrauen bei grenzüberschreitenden Transaktionen gestärkt wird.

esignglobal HK

Suchen Sie eine intelligentere Alternative zu DocuSign?

eSignGlobal bietet flexiblere und kostengünstigere E-Signatur-Lösungen mit globaler Compliance, transparenter Preisgestaltung und schnellerem Onboarding.

👉 Starten Sie eine kostenlose Testversion

HelloSign (Dropbox Sign): Einfachheit für KMUs

HelloSign, jetzt Teil von Dropbox, bietet eine intuitive Oberfläche für eine schnelle Einrichtung und robuste mobile Unterstützung durch reaktionsfähige Einbettung. Es ist kostengünstig für kleine Teams, aber es fehlt die erweiterte API-Tiefe von DocuSign, wobei der Schwerpunkt auf Benutzerfreundlichkeit und nicht auf Anpassung liegt.

Regionale E-Signatur-Bestimmungen

Obwohl der Titel keine Region angibt, ist das Verständnis der Gesetze für die API-Implementierung von entscheidender Bedeutung. In den USA bieten ESIGN und UETA eine breite Durchsetzbarkeit für elektronische Aufzeichnungen. Die eIDAS der EU standardisiert qualifizierte Signaturen für eine höhere Rechtswirkung. APAC variiert: Das Electronic Transactions Act von Singapur ähnelt ESIGN, erfordert aber lokale Datenresidenz, während Hongkong die Integration mit Systemen wie iAM Smart erfordert, um die Gültigkeit sicherzustellen. Unternehmen, die die DocuSign-API verwenden, müssen Umschläge entsprechend konfigurieren, um Compliance-Fallen zu vermeiden.

Fazit

Die API von DocuSign ermöglicht reaktionsfähige mobile Signaturen und fördert die Effizienz in einer digital orientierten Welt. Erwägen Sie für Alternativen eSignGlobal als regionale Compliance-Option, insbesondere in APAC, um Kosten und globale Abdeckung in Einklang zu bringen. Bewerten Sie anhand Ihrer Geschäftsanforderungen, um die beste Lösung zu finden.

Shunfang

Leiter des Produktmanagements bei eSignGlobal, eine erfahrene Führungskraft mit umfassender internationaler Erfahrung in der elektronischen Signaturbranche. Folgen Sie meinem LinkedIn