JetBrains Account API
通过 JetBrains Account API，您可以自动管理许可证，并从您的 JetBrains Account 检索许可证使用数据。
该 API 方法允许您获得许可证信息，分配或撤销许可证，并在团队之间重新分配。 您的 JetBrains Account 角色决定了您对 API 方法的访问权限。 如需了解更多信息，请查看 API 参考信息。
角色
API 有三个访问级别，它们反映了您在您的组织中可能被分配的角色。
- 组织管理员可以启用和禁用 API，为自己生成和重新生成一个令牌，并为组织中的任何用户（包括其他组织的管理员）删除访问令牌。
- 团队管理员可以为团队中的任何人（包括他们团队的任何其他管理员）生成、重新生成和删除访问令牌。
- 查看者和主要联系人可以为自己生成、重新生成和删除一个访问令牌。 查看者和主要联系人的访问令牌允许只读的 API 访问。
如何启用 API
要启用 API，请按照以下步骤操作。
- 用组织管理员的凭据登录到您的 JetBrains Account。
团队管理员不能启用或禁用 API。 - 在左侧菜单中，点击您的组织名称，然后点击 Administration（管理） 。
-
点击 Enable API（启用 API）。
这将使 API 可供所有组织和团队管理员，以及查看者和主要联系人使用。 所有具有指定角色的用户将能够生成令牌。。
如何禁用 API
要禁用 API，请按照上述步骤 1 和 2 进行操作，然后点击 Disable API （禁用 API）。
这个按钮使所有管理员、查看者和主要联系人的 API 禁用。
如何访问 API 的方法
要访问这些方法，您需要两个参数。
1. 您的 X-Customer-Code 参数客户代码
客户代码是唯一的的组织 ID。 要知道您的客户代码是什么，请转到您的 JetBrains Account，寻找您的组织名称旁边的数字。
将此值传给 X-Customer-Code 参数。
2. 您的 X-Api-Key 参数访问令牌
要生成访问令牌：
- 转到您的 JetBrains Account。
- 在左侧菜单中，点击您的组织或团队名称，然后点击 Administration（管理）
。 - 点击 Generate Token（生成令牌）。
- 弹出的对话框将显示您的令牌。 出于安全原因，令牌只会显示一次。 在关闭对话框之前，将其保存在安全位置。 不要与其他人分享您的令牌。
如果你丢失了您的令牌，您将需要生成新的。 生成一个新的令牌将使旧的令牌无效。
把您获得的令牌传给 X-Api-Key 参数。
令牌生命周期
无论您禁用和启用 API，您的访问令牌保持不变且有效，除非您手动生成新的。
每个用户，即使他们被分配了多个角色，都只有一个令牌。 只要用户保持至少一种角色，令牌就保持不变。 如果一个用户失去了他的所有角色，其访问令牌将被自动删除。