如何获取DocuSign收件人预览签名URL？请求报400错误咨询

• 校验请求体必填字段完整性
  收件人预览的POST请求必须包含以下核心字段，缺失任意一项都会触发400错误：

  • userName：收件人姓名
  • email：收件人邮箱（即使无需实际接收邮件，也需填写格式合法的邮箱，比如dummy@example.com）
  • recipientId：与信封创建时定义的收件人ID完全匹配
  • returnUrl：预览结束后跳转的应用URL

  合法请求体示例（JSON格式）：

  {
    "userName": "John Doe",
    "email": "john.doe@example.com",
    "recipientId": "1",
    "returnUrl": "https://your-app-domain.com/post-preview"
  }
  

• 确保收件人信息与信封配置一致
  请求体中的recipientId、email必须和信封创建时指定的收件人信息完全匹配，哪怕邮箱是虚拟占位的，也不能和信封内的配置冲突。

• 替换URL占位符
  确认请求URL中的{accId}和{envId}已替换为实际的账户ID和信封ID，不能保留占位符字符。

• 检查请求头与格式
  必须设置请求头Content-Type: application/json，同时保证请求体是语法正确的JSON（无缺失逗号、未闭合引号等问题）。

• 确认API版本兼容性
  确保使用的API版本为v2.1，与请求端点URL的版本标识一致，避免版本不兼容导致的解析错误。

完成以上校验后，重新发起POST请求即可获取包含url字段的响应，该字段即为收件人预览链接，无需等待邮箱通知即可直接访问。

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