JetBrains Account API

通過 JetBrains Account API,您可以自動管理授權,並從您的 JetBrains Account 檢索授權使用資料。

這個 API 方法允許您獲得授權信息,分配或撤銷授權,並在團隊之間重新分配。 您的 JetBrains Account 角色定義了您對 API 方法的訪問權限。 如需了解更多詳細信息,請訪問 API 參考資料

角色

API 有三個訪問級別,跟您在你的組織帳戶中可能被分配的角色權限一樣。 

  • 組織管理員可以啟用和禁用 API,為自己生成和重新生成一個 Token(權杖),並為組織中的任何人包括其他組織的管理員刪除訪問權杖。
  • 團隊管理員可以為團隊中的任何人(包括他們團隊的任何其他管理員)生成、重新生成和刪除訪問權杖。
  • 查看者主要聯繫人可以為自己生成、重新生成和刪除一個訪問權杖。 查看者和主要聯繫人的訪問令牌允許只讀的 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,您的訪問令牌保持不變且有效,除非您手動生成新的。 

每個用戶,即使他們被分配了多個角色,都只有一個令牌。 只要用戶保持至少一種角色,令牌就保持不變。 如果一個用戶失去了他的所有角色,他們的訪問令牌將被自動刪除。

23 人中有 12 人覺得有幫助

還有其他疑問?

提交請求