时间戳

首页 > 解决方案 > 为什么 userName 是信封视图的必需属性？

docusignapi - 为什么 userName 是信封视图的必需属性？

问题描述

我不确定这是否是一个错误。但是我在创建嵌入式签名链接时在沙盒中发现了这一点。

尝试使用以下正文调用以下帖子时，我收到 400 Bad RequestData Object errorCode: "INVALID_REQUEST_PARAMETER" message: "The request contained at least one invalid parameter. A value was not found for parameter 'userName'."

POST /v2/accounts/{accountId}/envelopes/{envelopeId}/views/recipient
Accept: application/json
Origin: https://apiexplorer.docusign.com
Content-Type: application/json

Show Base64 Bytes in Request
{
  "authenticationMethod": "none",
  "email": "myemail@example.com",
  "returnUrl": "google.com"
}

因此，将用户名添加到我的收件人是有意义的吗？嗯，是的，但不是。我可以输入任何随机的用户名，比如

{
  "authenticationMethod": "none",
  "email": "myemail@example.com",
  "returnUrl": "google.com",
  "userName": "sdlfkjsodisdofisdofm"
}

并且它将生成带有嵌入式链接的成功响应链接。它似乎首先寻找电子邮件作为我想要的优先级。userName 这里的目的是什么？

标签： docusignapi

解决方案

因此，我认为如果用户未通过身份验证（“无”），则 userName 将被忽略，但仍然是必需的。这似乎是一个错误，所以很好。如果您想进行更多测试 - 请尝试 v2.1，这是我们建议您使用的最新 API 版本，并查看其行为是否相同（最有可能，但不是 100% 肯定）。可能需要 userName 的原因是例如 InPersonSigner 或当您使用 recipientAuthentication 并且用户需要与某个帐户中的 DocuSign 用户相关联才能正确使用他们的身份验证时。

编辑：实际上，用户名将用于确定您的签名集。试试这个，设置你的签名并使用完全相同的用户名。DocuSign 应该记住它，您不必再这样做了。如果您使用不同的 - 您将不得不这样做。因此，也许毕竟不是错误...（对于您只需同意一次的电子同意书也是如此）

推荐阅读