检索尚未激活的用户的用户 ID 的简单方法？

Question

我通过 docusign api 配置用户，但新用户尚未处于活动状态（status=ActivationSent）。现在，无论出于何种原因，我都想取消配置该用户。取消配置 API 需要一个 userId。我的问题是有效地找到这个 userId。

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

我看到我可以使用端点 /accounts/{accountId}/users 获取帐户的所有用户列表，然后找到我感兴趣的用户和 userId。在这种情况下，有没有比获取 userId 更有效的方法查询所有用户？

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

Answer 1

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

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

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