如何在自有应用中获取Docusign待签署文档/信封的签署链接

该需求有成熟的落地方案，通过Docusign官方提供的eSignature API即可实现，不需要依赖官方发送的签署邮件，生成的跳转链接和邮件内的签署链接效果完全一致。

核心实现步骤 #

• 第一步：提前完成Docusign开发者账号注册、应用创建与授权，申请envelope_read、recipient_read两类核心API权限，若还需要通过你的应用发起签署流程，额外申请envelope_send权限即可。
• 第二步：拉取指定用户的待签署信封列表，调用GET /v2.1/accounts/{accountId}/envelopes接口，传入status=sent的过滤参数，同时可根据收件人邮箱、自定义用户ID做二次过滤，仅返回对应用户需要签署的信封数据。
• 第三步：实时生成官方签署跳转链接，用户在你的应用内点击对应信封的签署入口时，调用POST /v2.1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient接口，传入收件人姓名、邮箱、签署完成后的回跳地址、客户端IP等参数，接口返回的url字段就是所需的签署链接，用户点击后直接跳转至Docusign官方签署页，签署完成后自动回跳至你的自有应用。

注意事项 #

• 生成的签署链接默认有效期为5分钟，不要提前生成存储，建议用户触发签署操作时实时调用接口生成，避免过期失效。
• 若你需要将签署页直接嵌入到你的应用内，而非跳转官方页面，同样可以使用该生成的链接放在iframe中实现嵌入式签署，逻辑完全兼容。

代码示例（Python SDK） #

import docusign_esign as docusign
from docusign_esign.rest import ApiException

# 初始化API客户端
api_client = docusign.ApiClient()
api_client.host = "https://demo.docusign.net/restapi" # 生产环境替换为对应官方域名
api_client.set_default_header("Authorization", "Bearer " + 你的访问令牌)

# 构造收件人签署视图请求
view_request = docusign.RecipientViewRequest(
    return_url="https://你的自有应用回跳地址",
    recipient_email="签署人注册邮箱",
    recipient_id="1", # 对应信封中该签署人的ID，创建信封时可获取
    user_name="签署人姓名",
    client_user_id="你的自有应用内的用户ID（创建信封时已绑定的话传入）"
)

# 调用接口获取签署链接
envelope_api = docusign.EnvelopesApi(api_client)
recipient_view = envelope_api.create_recipient_view(你的账号ID, 目标信封ID, recipient_view_request=view_request)
sign_url = recipient_view.url

内容的提问来源于stack exchange，提问作者riza446