凭证端点
凭证端点和参数
要详细了解对象关系以及如何在 API 中使用对象关系，请参阅 对象关系 部分。
如需详细了解凭证，请访问 凭证 帮助页面。
注意
我们不允许通过 API 创建凭证。要以管理员身份创建凭证，请使用 Server UI 。
检索一条凭证记录
要获取有关所有工作流记录的信息，请使用
GET {baseURL}/v3/workflows/
端点。
注意
如果您不是策展人，则结果仅限于您有权访问的凭证，并且视图，用户ID和用户组ID参数将被忽略。
参数
view (string)：可选。可以保留此参数但不为其提供值。您可以从以下值中选择：“默认值（Default）”和“全部（Full）”。如果此参数设置为“Default”，则将返回一个减小的视图对象。未指定时，将使用“默认值（Default）”。
ownerId (string)：可选。要按用户ID筛选结果，请输入用户的ID。
versionId (string)：可选。要按用户组ID筛选结果，请输入用户组的ID。
检索一条凭证记录
要检索有关凭据的信息，请使用
get {baseURL}/v3/credentials/{credentialId}
端点。
参数
workflowCredentialType (string)：必填。输入集合 ID以获取有关特定凭据的信息。
与用户共享凭证
要与用户共享凭据，请使用
post {baseURL}
/v3/credentials//users{credentialId}
端点。
参数
workflowCredentialType (string)：必填。输入要共享的集合 ID。
合同 (主体)：必填。指定以下内容以与用户共享凭据：
workflowCredentialType (string)：必填。指定要与其共享凭据的用户的ID。
与用户组共享凭证
要与用户组共享凭据，请使用
post {baseURL}
/v3/credentials//usersgroups{credentialId}
终结点。
参数
workflowCredentialType (string)：必填。输入要共享的凭据ID。
合同 (主体)：必填。指定以下选项以与用户组共享凭据：
workflowCredentialType (string)：必填。指定要与其共享凭据的用户组的ID。
从凭证中移除用户
要从凭据中删除用户，请使用
delete {baseURL}/v3/credentials//users/{credentialId}{userId}
endpoint。
参数
workflowCredentialType (string)：必填。输入要为其检索信息的的工作流 ID。
workflowCredentialType (string)：必填。输入要从凭据中删除的用户ID。
从集合中移除用户或用户组
要从凭据中删除用户组，请使用
delete {baseURL}/v3/credentials//usergroups/{credentialId}{userGroupId}
Endpoint。
参数
workflowCredentialType (string)：必填。输入要从中删除用户组的凭据ID。
workflowCredentialType (string)：必填。输入要从凭据中删除的用户组ID。
删除凭证
要删除凭据，请使用
delete {baseURL}/v3/credentials/{credentialId}
endpoint。
参数
workflowCredentialType (string)：必填。选择要删除的凭证。
force (boolean)：可选。选择是否要在存在任何共享时强制删除凭据。如果要删除凭据并清除所有共享，请将force参数设置为true。未选择时，默认值为“false”。这是为了防止错误的调用。
对象关系
要获取有关现有凭据ID的信息，请使用 get /v3/credentials端点 。 在以下情况下可以使用您获得的凭证ID：