這是第一版 API。我們會根據回饋持續擴充功能——告訴我們你需要哪些 endpoint!
驗證
建立 API 金鑰
- 前往 cursor.com/dashboard → Settings 分頁 → Cursor Admin API Keys
- 點擊 Create New API Key
- 幫金鑰取個具體好懂的名稱(例如:「Usage Dashboard Integration」)
- 立即複製產生的金鑰——之後就無法再查看
key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
使用你的 API 金鑰
基底 URL
端點
取得團隊成員
回應
範例回覆
範例請求
取得每日使用量資料
請求本文
參數 | 型別 | 必填 | 說明 |
---|---|---|---|
startDate | number | Yes | 以 epoch 毫秒為單位的開始日期 |
endDate | number | Yes | 以 epoch 毫秒為單位的結束日期 |
日期範圍不能超過 90 天。超過的話請分多次發送請求。
回應
回應欄位
欄位 | 說明 |
---|---|
date | 以 epoch 毫秒表示的日期 |
isActive | 該日使用者是否為活躍 |
totalLinesAdded | 新增的程式碼行數 |
totalLinesDeleted | 刪除的程式碼行數 |
acceptedLinesAdded | 由已接受的 AI 建議新增的行數 |
acceptedLinesDeleted | 由已接受的 AI 建議刪除的行數 |
totalApplies | Apply 操作次數 |
totalAccepts | 已接受的建議數 |
totalRejects | 已拒絕的建議數 |
totalTabsShown | 顯示的 Tab 補全次數 |
totalTabsAccepted | 接受的 Tab 補全次數 |
composerRequests | Composer 請求數 |
chatRequests | Chat 請求數 |
agentRequests | Agent 請求數 |
cmdkUsages | 指令面板(Cmd+K)使用次數 |
subscriptionIncludedReqs | 訂閱內含額度的請求數 |
apiKeyReqs | API 金鑰請求數 |
usageBasedReqs | 依用量計費的請求數 |
bugbotUsages | Bug 偵測使用次數 |
mostUsedModel | 最常使用的 AI 模型 |
applyMostUsedExtension | Apply 操作最常用的副檔名 |
tabMostUsedExtension | Tab 最常用的副檔名 |
clientVersion | Cursor 版本 |
email | 使用者電子郵件 |
回應範例
範例請求
取得支出資料
請求本文
參數 | 型別 | 必填 | 說明 |
---|---|---|---|
searchTerm | string | No | 在使用者名稱與電子郵件中搜尋 |
sortBy | string | No | 依以下欄位排序:amount 、date 、user 。預設為:date |
sortDirection | string | No | 排序方向:asc 、desc 。預設為:desc |
page | number | No | 頁碼(從 1 起算)。預設為:1 |
pageSize | number | No | 每頁結果數 |
回應
回應欄位
欄位 | 說明 |
---|---|
spendCents | 總支出(單位:分) |
fastPremiumRequests | Fast Premium 模型請求數 |
name | 成員名稱 |
email | 成員電子郵件 |
role | 團隊角色 |
hardLimitOverrideDollars | 自訂支出上限覆寫值 |
subscriptionCycleStart | 訂閱週期開始時間(epoch 毫秒) |
totalMembers | 團隊成員總數 |
totalPages | 總頁數 |
範例回應
範例請求
取得使用事件資料
請求主體
參數 | 類型 | 必填 | 說明 |
---|---|---|---|
startDate | number | 否 | 起始日期(epoch 毫秒) |
endDate | number | 否 | 結束日期(epoch 毫秒) |
userId | number | 否 | 依特定使用者 ID 篩選 |
page | number | 否 | 頁碼(從 1 起算)。預設值:1 |
pageSize | number | 否 | 每頁結果數。預設值:10 |
email | string | 否 | 依使用者電子郵件地址篩選 |
回應
回應欄位說明
欄位 | 說明 |
---|---|
totalUsageEventsCount | 與查詢相符的使用事件總數 |
pagination | 用於瀏覽結果的分頁後設資料 |
timestamp | 事件時間戳(自紀元起的毫秒數) |
model | 這次請求使用的 AI 模型 |
kind | 使用類別(例如:「Usage-based」、「Included in Business」) |
maxMode | 是否啟用 Max 模式 |
requestsCosts | 以請求單位計算的成本 |
isTokenBasedCall | 事件是否以用量計費(true) |
tokenUsage | 詳細的權杖(token)使用量(當 isTokenBasedCall 為 true 時提供) |
isFreeBugbot | 是否為免費 Bugbot 使用 |
userEmail | 發出請求的使用者 Email |
period | 查詢資料的日期範圍 |
回應範例
範例請求
設定使用者花費上限
速率限制: 每個團隊每分鐘 60 次請求
Request Body
Parameter | Type | Required | Description |
---|---|---|---|
userEmail | string | Yes | 團隊成員的電子郵件地址 |
spendLimitDollars | number | Yes | 支出上限(美元),僅限整數,不能有小數。 |
- 使用者必須已經是你團隊的成員
- 只接受整數值(不接受小數金額)
- 將
spendLimitDollars
設為 0 會把上限設為 $0
回應
範例回應
範例請求
Repo Blocklists API
取得團隊 Repo 封鎖清單
回應
範例回覆
範例請求
新增或更新 Repo 封鎖名單
請求本文
參數 | 類型 | 必填 | 說明 |
---|---|---|---|
repos | array | Yes | 儲存庫封鎖清單物件的陣列 |
欄位 | 類型 | 必填 | 說明 |
---|---|---|---|
url | string | Yes | 要加入封鎖清單的儲存庫 URL |
patterns | string[] | Yes | 要封鎖的檔案模式陣列(支援 glob 模式) |
回應
範例請求
刪除 Repo 封鎖清單
參數
參數 | 類型 | 必填 | 說明 |
---|---|---|---|
repoId | string | 是 | 要刪除的儲存庫封鎖清單 ID |
回應
範例請求
範例模式
*
- 封鎖整個 repository*.env
- 封鎖所有 .env 檔案config/*
- 封鎖 config 資料夾中的所有檔案**/*.secret
- 封鎖任何子資料夾中的所有 .secret 檔案src/api/keys.ts
- 封鎖特定檔案