使用Docusign SDK获取已签署信封签名的API及参数相关问题咨询

接口有效性确认 #

你找到的/restapi/v2.1/accounts/{accountId}/users/{userId}/signatures/{signatureId}是官方合法接口，但它的作用是获取DocuSign用户账号下预先保存的签名样本，不用于获取特定信封签署流程中产生的签名内容。
如果你需要获取指定信封内签署人提交的签名，应该使用/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/signature_image接口。

SDK 对应调用方法 #

所有官方DocuSign SDK都对上述两个接口做了封装，此处以Python SDK为例给出调用示例，其他语言SDK的方法命名和参数结构基本一致：

• 获取用户预存签名的调用方法：

from docusign_esign import AccountsApi, ApiClient

# 完成SDK鉴权初始化后调用
accounts_api = AccountsApi(api_client)
signature_info = accounts_api.get_user_signature(
    account_id="你的账户ID",
    user_id="目标用户ID",
    signature_id="目标签名ID"
)

• 获取指定信封内签署人签名的调用方法：

from docusign_esign import EnvelopesApi, ApiClient

# 完成SDK鉴权初始化后调用
envelopes_api = EnvelopesApi(api_client)
signature_image = envelopes_api.get_recipient_signature_image(
    account_id="你的账户ID",
    envelope_id="目标信封ID",
    recipient_id="对应签署人ID"
)

signatureId 参数获取规则 #

如果你使用的是获取用户预存签名的接口，signatureId不需要你在应用内自行定义，你可以先调用accounts_api.list_user_signatures(account_id, user_id)获取对应用户名下所有预存签名的列表，列表返回结果中每个签名条目都会自带对应的signatureId，你可以将该值存储到你的应用数据库中供后续调用使用。
如果你使用的是获取信封内签名的接口，不需要传入signatureId参数，仅需要提供信封ID和签署人ID即可正常调用。

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