JetBrains Account API

通过 JetBrains Account API,您可以自动管理许可证,并从您的 JetBrains Account 检索许可证使用数据。

该 API 方法允许您获得许可证信息,分配或撤销许可证,并在团队之间重新分配。 您的 JetBrains Account 角色决定了您对 API 方法的访问权限。 如需了解更多信息,请查看 API 参考信息

角色

API 有三个访问级别,它们反映了您在您的组织中可能被分配的角色。 

  • 组织管理员可以启用和禁用 API,为自己生成和重新生成一个令牌,并为组织中的任何用户(包括其他组织的管理员)删除访问令牌。
  • 团队管理员可以为团队中的任何人(包括他们团队的任何其他管理员)生成、重新生成和删除访问令牌。
  • 查看者主要联系人可以为自己生成、重新生成和删除一个访问令牌。 查看者和主要联系人的访问令牌允许只读的 API 访问。

如何启用 API

要启用 API,请按照以下步骤操作。 

  1. 组织管理员的凭据登录到您的 JetBrains Account。
    团队管理员不能启用或禁用 API。
  2. 在左侧菜单中,点击您的组织名称,然后点击 Administration(管理)
  3. 点击 Enable API(启用 API)。
    mceclip3.png
    这将使 API 可供所有组织和团队管理员,以及查看者和主要联系人使用。 所有具有指定角色的用户将能够生成令牌。

如何禁用 API

要禁用 API,请按照上述步骤 1 和 2 进行操作,然后点击 Disable API (禁用 API)。

mceclip2.png

这个按钮使所有管理员、查看者和主要联系人的 API 禁用。

如何访问 API 的方法

要访问这些方法,您需要两个参数。 

1. 您的 X-Customer-Code 参数客户代码

客户代码是唯一的的组织 ID。 要知道您的客户代码是什么,请转到您的 JetBrains Account,寻找您的组织名称旁边的数字。

find-profile-id.png

 

将此值传给 X-Customer-Code 参数。

 

2. 您的 X-Api-Key 参数访问令牌

要生成访问令牌:

  1. 转到您的 JetBrains Account。 
  2. 在左侧菜单中,点击您的组织或团队名称,然后点击 Administration(管理)
  3. 点击 Generate Token(生成令牌)。
    generate-token-screen.png
  4. 弹出的对话框将显示您的令牌。 出于安全原因,令牌只会显示一次。 在关闭对话框之前,将其保存在安全位置。 不要与其他人分享您的令牌。
    mceclip0.png
    如果你丢失了您的令牌,您将需要生成新的。 生成一个新的令牌将使旧的令牌无效。

把您获得的令牌传给 X-Api-Key 参数。

令牌生命周期

无论您禁用和启用 API,您的访问令牌保持不变且有效,除非您手动生成新的。 

每个用户,即使他们被分配了多个角色,都只有一个令牌。 只要用户保持至少一种角色,令牌就保持不变。 如果一个用户失去了他的所有角色,其访问令牌将被自动删除。

22 人中有 11 人觉得有帮助

还有其他问题?

提交请求