JetBrains Account API
通過 JetBrains Account API，您可以自動管理授權，並從您的 JetBrains Account 檢索授權使用資料。
這個 API 方法允許您獲得授權信息，分配或撤銷授權，並在團隊之間重新分配。 您的 JetBrains Account 角色定義了您對 API 方法的訪問權限。 如需了解更多詳細信息，請訪問 API 參考資料。
角色
API 有三個訪問級別，跟您在你的組織帳戶中可能被分配的角色權限一樣。
- 組織管理員可以啟用和禁用 API，為自己生成和重新生成一個 Token（權杖），並為組織中的任何人包括其他組織的管理員刪除訪問權杖。
- 團隊管理員可以為團隊中的任何人（包括他們團隊的任何其他管理員）生成、重新生成和刪除訪問權杖。
- 查看者和主要聯繫人可以為自己生成、重新生成和刪除一個訪問權杖。 查看者和主要聯繫人的訪問令牌允許只讀的 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，您的訪問令牌保持不變且有效，除非您手動生成新的。
每個用戶，即使他們被分配了多個角色，都只有一個令牌。 只要用戶保持至少一種角色，令牌就保持不變。 如果一個用戶失去了他的所有角色，他們的訪問令牌將被自動刪除。