无法通过DocuSign API隐藏envelope_id，报INVALID_REQUEST_PARAMETER错误

开发者阿泽

2026-7-29

解决DocuSign API隐藏信封ID时的400参数错误

问题概述

调用DocuSign API创建信封并尝试隐藏信封ID时，返回400 Bad Request错误，提示envelopeIdStamping参数需要布尔值，但代码中已设置envelope_id_stamping=False。核心错误信息：

错误代码：INVALID_REQUEST_PARAMETER
错误信息：The request contained at least one invalid parameter. Boolean value expected for parameter: envelopeIdStamping
Trace-Token: 52331e18-55c5-4801-8c55-c6e4fd4a5712

解决方案

1. 升级DocuSign Python SDK到最新版本

旧版本SDK可能存在envelope_id_stamping参数的布尔值序列化bug，或者未完整支持该参数。执行以下命令升级：

pip install --upgrade docusign-esign

2. 修正参数命名格式

部分SDK版本要求参数使用驼峰式命名而非下划线式，将代码中的envelope_id_stamping改为envelopeIdStamping：

envelope_definition = EnvelopeDefinition(
    email_subject="Please sign this document sent from the Python SDK",
    template_id=template_id,
    template_roles=[signer],
    status="sent",
    envelopeIdStamping=False,
)

3. 验证请求体的布尔值格式

如果SDK仍存在序列化问题，可以手动构造JSON请求体，确保envelopeIdStamping是**布尔值false**而非字符串"false"：

{
  "emailSubject": "Please sign this document sent from the Python SDK",
  "templateId": "你的模板ID",
  "templateRoles": [你的签署人配置],
  "status": "sent",
  "envelopeIdStamping": false
}