DocuSign添加用户

Question

我正在尝试使用docuSign演练添加用户，但收到以下错误：

{    
   "newUsers": [
    {
      "email": "j@hotmail.com",
      "userName": "j@hotmail.com",
      "errorDetails": {
      "errorCode": "INVALID_PASSWORD_CHALLENGE",
       "message": "Invalid forgotten password challenge."
     }
 }
]

}

请求正文为：

{
  "newUsers": [
    {
      "userSettings": [
         {
           "value": "false",
           "name": "allowSendOnBehalfOf"
         }
       ],
       "suffixName": "jr",
       "lastName": "test",
       "middleName": "test",
       "firstName": "test",
       "title": "test",
       "password": "Lagzzzz1234444",
       "userName": "j@hotmail.com",
       "email": "j@hotmail.com"
    }
  ]
}

那么，我做错了什么呢？

顺便说一句，我在使用自己的WEb应用编程接口程序时也遇到了同样的错误。

Answer 1

正如Andrew在他上面的评论中提到的，之所以会出现这个错误，是因为您的"Create User“请求主体缺少forgottenPasswordInfo所需的信息，而您的DocuSign帐户设置当前指定所有新用户必须至少有1个(或更多)密码提醒问题/答案对。

如果您将forgottenPasswordInfo属性添加到您的请求中(如下面的请求示例所示--除了为每个问题和答案提供您自己的定制值之外)，则应该成功创建了用户。

POST https://demo.docusign.net/restapi/v2/accounts/201105/users

{
  "newUsers": [
    {
        "lastName": "HollisterTest",
        "firstName": "Johnny",
        "password": "johnnyspassword",
        "userName": "test123ghy@hotmail.com",
        "email": "test123ghy@hotmail.com",
        "forgottenPasswordInfo": {
            "forgottenPasswordQuestion1": "This is question_1?",
            "forgottenPasswordAnswer1": "answer_1",
            "forgottenPasswordQuestion2": "This is question_2?",
            "forgottenPasswordAnswer2": "answer_2",
            "forgottenPasswordQuestion3": "This is question_3?",
            "forgottenPasswordAnswer3": "answer_3",
            "forgottenPasswordQuestion4": "This is question_4?",
            "forgottenPasswordAnswer4": "answer_4"
        }
    }
  ]
}

如果您不想在您的“创建用户”应用编程接口调用中提供密码提醒问题/答案信息，您也可以更改您的DocuSign帐户设置，以便新用户不需要密码提醒问题。导航到Preferences >> Feature >> Password Strength (链接)，将Password Strength下拉列表更改为"Custom“，将Password Questions Required更改为"0”(并根据需要指定其他设置)：

​

​

注意:我假设当您说这个调用在"DocuSign演练“中不起作用时，您指的是IODocs。我已经确认了IODocs存在一个问题，即除非请求主体包含forgottenPasswordInfo属性(如果DocuSign帐户设置需要提醒Q&A)，否则“创建用户”调用将不起作用--但是IODocs不会在用户界面中公开此属性以供用户设置。尽管IODocs是一个整洁的工具，并且是探索DocuSign REST API的一个很好的起点，但是对于您想要测试的情况，它并不总是100%完整/正确。与其依赖IODocs，不如习惯于将DocuSign REST API guide与REST API help page结合使用，并利用Postman (在Chrome浏览器中)这样的工具来构造和测试您的API调用。

Answer 2

你可以要求DocuSign支持激活“静默激活”。然后，当你通过API激活用户时，自动激活状态，他们不必通过电子邮件中的URL激活他们的帐户。

米哈尔