管理员如何通过DocuSign API修改用户配置文件

Question

在DoucSign API参考中有关修改用户配置文件（Link Here）的说明：

  

uri中指定的userId必须与经过身份验证的用户的userId匹配，并且该用户必须是该帐户的成员。

管理员如何通过API修改普通用户的个人资料？

（注意：管理员不知道用户的密码。）

Answer 1

首先，“admin”用户（即API请求的身份验证用户）必须在DocuSign中为其成员帐户启用这些设置：

然后，只需在提交API请求以修改用户的个人资料信息时使用“代表发送”功能。为此，您只需在API请求的 X-DocuSign-Authentication 标头中提供管理员信息（与所有其他API调用一样），并指定与之对应的电子邮件地址。您要修改的用户帐户（作为 X-DocuSign-Authentication 标题中 SendOnBehalfOf 属性的值）。

例如，请考虑以下API请求（包括请求的 X-Docusign-Authentication 标头）。在此示例中，John是“admin”用户（johnDoe@gmail.com），Jane是将更新配置文件的用户（janeSmith@hotmail.com） - 此请求会将Jane的姓改为 New_LastName < / em>的。

PUT https://demo.docusign.net/restapi/v2/accounts/201105/users/USER_ID_OF_PROFILE_TO_UPDATE/profile 

X-DocuSign-Authentication: {"Username":"johnDoe@gmail.com","Password":"johnsPassword","IntegratorKey":"ABCD-eae5f282-d9f6-47c3-b293-1c4cf78d85kj","SendOnBehalfOf":"janeSmith@hotmail.com" }

{
    "userDetails":{
        "lastName":"New_LastName"
    }
}

在 X-DocuSign-Authentication 标题内：

• 用户名代表“admin”用户帐户的电子邮件地址
• 密码表示与“admin”用户帐户
对应的密码
• IntegratorKey 表示与DocuSign帐户对应的集成商键值
• SendOnBehalfOf 表示与API请求将修改的用户帐户对应的电子邮件地址。此电子邮件地址应与API请求URI中 USER_ID_OF_PROFILE_TO_UPDATE 的值所代表的用户帐户相对应。

DocuSign REST API Guide包含有关“代表发送”功能的信息。