检索尚未激活的用户的userId的简便方法？

Question

我通过docusign api配置用户，但新用户尚未激活（status = ActivationSent）。现在无论出于什么原因我想取消这个用户。 deprovision API需要userId。我的问题是有效地找到这个userId。

我尝试使用端点获取用户信息 /accounts/{accountId}/users?email={emailAddress}但它返回了400，错误代码为USER_LACKS_MEMBERSHIP。

我看到我可以使用结束点/accounts/{accountId}/users获取帐户的所有用户列表，然后查找我感兴趣的用户和userId。是否有更有效的方法来获取userId方案比查询所有用户？

还有相应的SOAP调用来获取帐户的所有用户吗？我在SOAP文档中找不到它。

Answer 1

据我所知，您描述的方法（检索所有用户的列表，然后遍历列表以查找要取消配置的用户）是查找/检索用户的唯一方法具有 userStatus =“已发送激活”的用户的ID 。不幸的是（正如您所发现的），/accounts/{accountId}/users?email={emailAddress}仅对“有效”用户有效。

尽管如此 - 当您通过REST API（POST /accounts/{accountId}/users）配置用户时，成功的响应应该包含新用户的 userId 。也许您的应用程序可以存储每次配置新用户时在响应中收到的 userId ，然后您可以随后使用 userId 值取消配置用户if / when必要的。

我对SOAP API不太熟悉，但我没有在DocuSign SOAP API指南中看到“获取所有用户”操作。我希望这种类型的操作成为“帐户管理服务API”的一部分，但我没有在那里看到它。