DocuSign API: Menjana URL Tandatangan Terbenam dengan Tempoh Luput Tertentu

Menavigasi API DocuSign untuk Tandatangan Terbenam yang Selamat

Dalam landskap protokol digital yang sentiasa berkembang, perniagaan semakin bergantung pada platform tandatangan elektronik untuk menyelaraskan aliran kerja sambil memastikan keselamatan dan pematuhan. DocuSign, sebagai peneraju dalam bidang ini, menawarkan keupayaan API yang mantap yang membolehkan pembangun menyepadukan proses tandatangan terus ke dalam aplikasi mereka. Salah satu fungsi utama ialah menjana URL tandatangan terbenam, yang membolehkan pengguna menandatangani dokumen tanpa meninggalkan aplikasi hos. Artikel ini meneroka cara mencapai ini menggunakan API DocuSign, dengan tumpuan pada menetapkan masa tamat tertentu untuk kawalan yang dipertingkatkan. Dari sudut pandang komersial, penyepaduan sedemikian boleh mengurangkan geseran dalam penerimaan pelanggan dan pelaksanaan kontrak, yang berpotensi meningkatkan kadar penukaran sehingga 30% berdasarkan penanda aras industri.

Peranan Tandatangan Terbenam dalam Proses Perniagaan Moden

Tandatangan terbenam membenarkan dokumen dipaparkan dalam iframe atau paparan web, mewujudkan pengalaman pengguna yang lancar. Tidak seperti tandatangan jauh, yang memerlukan penerima mengakses pautan melalui e-mel, tandatangan terbenam sesuai untuk senario dalam aplikasi seperti portal jualan atau sistem HR. API DocuSign menyokong fungsi ini melalui eSignature REST APInya, membolehkan kawalan terprogram ke atas upacara tandatangan. Perniagaan menghargai ini kerana keupayaannya untuk mengekalkan konsistensi jenama dan mengumpul peristiwa penyelesaian masa nyata.

Menetapkan masa tamat untuk URL ini menambah lapisan keselamatan, menghalang akses tanpa kebenaran selepas tempoh yang ditetapkan. Ini amat berguna dalam industri berisiko tinggi seperti kewangan atau undang-undang, di mana dokumen sensitif masa mesti dilindungi daripada serangan ulangan atau pendedahan tanpa had.

Membandingkan platform tandatangan elektronik dengan DocuSign atau Adobe Sign?

eSignGlobal menawarkan penyelesaian tandatangan elektronik yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan pengalaman penerimaan yang lebih pantas.

👉 Mulakan Percubaan Percuma

Melaksanakan URL Tandatangan Terbenam dengan API DocuSign

Untuk menjana URL tandatangan terbenam dengan tamat tempoh tertentu, pembangun mesti mengesahkan melalui OAuth 2.0 dan berinteraksi dengan API Envelopes DocuSign. Proses ini melibatkan penciptaan sampul surat, penyediaan tandatangan, dan kemudian mendapatkan URL sementara untuk pembenaman. Dari sudut pandang komersial, menguasai fungsi ini boleh mengurangkan kos operasi dengan mengautomasikan susulan manual dan menyepadukan dengan alat CRM seperti Salesforce.

Langkah 1: Pengesahan dan Penciptaan Sampul Surat

Mula-mula, dapatkan token akses menggunakan aliran pemberian JWT atau Kod Kebenaran DocuSign. Token ini memberikan akses API sehingga 8 jam, selepas itu ia mesti disegarkan.

Gunakan titik akhir /accounts/{accountId}/envelopes untuk mencipta sampul surat. Berikut ialah contoh permintaan format JSON melalui POST:

{
  "emailSubject": "Sila tandatangani dokumen ini",
  "documents": [
    {
      "documentBase64": "base64-encoded-document-content",
      "name": "Agreement.pdf",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "status": "sent"
}

Ini mencipta sampul surat asas dengan seorang penandatangan. status: "sent" memulakan aliran kerja dengan serta-merta.

Langkah 2: Menambah Medan Tandatangan dan Penerima Terbenam

Untuk tandatangan terbenam, tetapkan penerima sebagai terbenam dengan memasukkan clientUserId dan butiran pengesahan. Kemas kini penerima:

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "clientUserId": "unique-client-id-123",
    "userId": "signer-user-id",
    "authenticationMethod": "none",  // atau "email" untuk keselamatan tambahan
    "embedUrlEvents": {
      "url": "https://your-app.com/return-url"
    }
  }
]

clientUserId mengikat sesi kepada aplikasi anda, memastikan penandatangan disahkan dalam persekitaran anda.

Seterusnya, tentukan medan tandatangan menggunakan titik akhir /envelopes/{envelopeId}/recipients/{recipientId}/tabs. Untuk medan tandatangan yang mudah:

{
  "signHereTabs": [
    {
      "documentId": "1",
      "pageNumber": "1",
      "xPosition": "100",
      "yPosition": "200",
      "width": "200",
      "height": "50",
      "recipientId": "1"
    }
  ]
}

Ini meletakkan tab tandatangan pada dokumen.

Langkah 3: Menjana URL Tandatangan Terbenam dengan Tamat Tempoh

Langkah teras ialah memanggil titik akhir /accounts/{accountId}/envelopes/{envelopeId}/views/recipient untuk mendapatkan URL tandatangan. Tentukan returnUrl untuk pengalihan selepas tandatangan dan tetapkan masa tamat melalui parameter pertanyaan atau tetapan sampul surat.

Contoh permintaan GET:

GET /accounts/{accountId}/envelopes/{envelopeId}/views/recipient?email=signer@example.com&userName=John%20Doe&returnUrl=https://your-app.com/complete

Respons termasuk medan url dengan pautan tandatangan terbenam, yang sah secara lalai selama 5 minit. Untuk menyesuaikan masa tamat, gunakan sifat expireAfter sampul surat (dalam hari) semasa penciptaan, atau gunakan expireEnabled dan expireAfterDays API dalam konfigurasi lanjutan. Untuk kawalan berbutir, bersepadu dengan Pemberitahuan Peristiwa DocuSign untuk memantau dan membatalkan akses selepas tamat tempoh.

Dalam kod (contoh Python menggunakan pustaka requests):

import requests

headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json'
}

# Create envelope (as above)
envelope_response = requests.post(f'{base_url}/envelopes', json=envelope_data, headers=headers)
envelope_id = envelope_response.json()['envelopeId']

# Get embedded URL
url_params = {
    'email': 'signer@example.com',
    'userName': 'John Doe',
    'returnUrl': 'https://your-app.com/complete'
}
url_response = requests.get(f'{base_url}/envelopes/{envelope_id}/views/recipient', params=url_params, headers=headers)
signing_url = url_response.json()['url']

URL ini kini boleh dibenamkan dalam iframe: <iframe src="{signing_url}" width="100%" height="600px"></iframe>. Masa tamat memastikan pautan tidak sah selepas masa yang ditetapkan, biasanya dikuatkuasakan oleh bahagian pelayan untuk mengelakkan gangguan.

Amalan Terbaik dan Pertimbangan Komersial

Dari pemerhatian komersial, melaksanakan masa tamat boleh mengurangkan liabiliti dalam industri yang dikawal selia. Pantau penggunaan API melalui papan pemuka DocuSign untuk mengelakkan had kuota—pelan Starter dihadkan pada 40 sampul surat sebulan, manakala pelan Advanced pada $5760 setahun menawarkan lebih banyak. Uji dalam mod kotak pasir untuk memastikan pematuhan dengan ESIGN/UETA di AS atau eIDAS di EU. Perangkap biasa termasuk clientUserId yang tidak sepadan yang menyebabkan kegagalan pengesahan, atau mengabaikan returnUrl yang menjejaskan kesinambungan aliran pengguna.

Perniagaan melaporkan bahawa tandatangan terbenam dengan tamat tempoh boleh mengurangkan masa tandatangan sebanyak 50%, meningkatkan kepuasan pelanggan. Walau bagaimanapun, kos API meningkat dengan penggunaan, jadi menilai alternatif untuk kecekapan kos adalah penting.

Membandingkan Platform Tandatangan Elektronik Terkemuka

Apabila memilih penyelesaian tandatangan elektronik, faktor seperti fleksibiliti API, harga dan pematuhan serantau memainkan peranan penting. Berikut ialah perbandingan neutral DocuSign, Adobe Sign, eSignGlobal dan HelloSign (kini Dropbox Sign) berdasarkan data awam 2025. Jadual ini menyerlahkan perbezaan utama untuk menyokong membuat keputusan yang termaklum.

Perbandingan ini menyerlahkan bahawa DocuSign cemerlang dalam penyepaduan perusahaan tetapi pada harga yang lebih tinggi, manakala platform lain menawarkan nilai dalam bidang tertentu.

DocuSign menonjol dengan ekosistem APInya yang matang, memacu tandatangan terbenam dalam beribu-ribu aplikasi di seluruh dunia. Program pembangunnya, daripada asas pada $600 setahun kepada pilihan perusahaan tersuai, menekankan kebolehskalaan untuk perniagaan volum tinggi.

Adobe Sign, yang disepadukan secara mendalam dengan aliran kerja kreatif dan dokumen, menawarkan tandatangan terbenam melalui APInya, dengan pilihan tamat tempoh yang dikaitkan dengan kitaran hayat sampul surat. Harga bermula lebih tinggi, tetapi pembundelan dengan Acrobat sesuai untuk pengguna intensif PDF.

eSignGlobal menyediakan tandatangan elektronik yang mematuhi di 100 negara global arus perdana, dengan kehadiran yang kukuh di rantau Asia Pasifik (APAC). Landskap tandatangan elektronik APAC mempersembahkan perpecahan, piawaian tinggi dan peraturan yang ketat, berbeza dengan rangka kerja ESIGN/eIDAS Barat. APAC memerlukan pendekatan "penyepaduan ekosistem", termasuk penyepaduan perkakasan/API yang mendalam dengan identiti digital kerajaan (G2B), jauh melangkaui kaedah e-mel atau pengisytiharan kendiri yang biasa di AS/EU. eSignGlobal bersaing secara langsung dengan DocuSign dan Adobe Sign melalui harga yang berpatutan—pelan Essentialnya pada $16.6 sebulan membenarkan sehingga 100 dokumen dihantar, tempat duduk pengguna tanpa had dan pengesahan kod akses tandatangan. Ia disepadukan dengan lancar dengan iAM Smart Hong Kong dan Singpass Singapura, memastikan pematuhan serantau pada sebahagian kecil daripada kos pesaing.

Mencari alternatif yang lebih bijak kepada DocuSign?

eSignGlobal menawarkan penyelesaian tandatangan elektronik yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan pengalaman penerimaan yang lebih pantas.

👉 Mulakan Percubaan Percuma

HelloSign (kini Dropbox Sign) mengutamakan kesederhanaan dalam API URL terbenamnya, dengan tamat tempoh dikendalikan melalui tetapan dokumen. Ia kos efektif untuk pasukan kecil tetapi kekurangan kedalaman automasi DocuSign.

Kesimpulan: Memilih Penyelesaian yang Tepat untuk Perniagaan Anda

Kesimpulannya, API DocuSign untuk menjana URL tandatangan terbenam dengan tamat tempoh tertentu menawarkan kawalan yang mantap untuk aliran kerja yang selamat dan bersepadu. Perniagaan harus menimbang kematangan API berbanding jumlah kos pemilikan dan keperluan serantau. Bagi perniagaan yang mengutamakan pematuhan APAC, eSignGlobal menonjol sebagai alternatif DocuSign yang neutral dan dioptimumkan secara serantau.