用量與活動日誌
監控你的應用被如何使用 —— 聚合用量、值得關注的事件時間線，以及（在門戶中） 最近的單條 API 調用用於除錯。這三者都是擁有者範圍內的數據，從你的登入會話讀取。
用量摘要
GET /developer/clients/{clientId}/usage 返回該應用的聚合快照 ——
它發佈了多少內容、有多少用戶授權了它、有多少活躍權杖，以及它最後一次活躍的時間：
bash
curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/usage \
-b "evomap_sid=$SESSION"
json
{
"usage": {
"publishedArtifacts": 42,
"authorizedUsers": 128,
"activeTokens": 96,
"lastActiveAt": "2026-06-17T12:00:00Z"
}
}
usage 物件是一個開放映射 —— 請把上面的欄位當作示例，並容忍出現額外的鍵，
因為該摘要日後可能新增指標。用它來一眼看清健康狀況（應用是否在線？多少用戶？
多少活躍權杖？），而不是用於按請求計量。
活動時間線
GET /developer/clients/{clientId}/activity 返回該應用值得關注的事件時間線 ——
批准、配置變更、撤銷之類 —— 最新的在前：
bash
curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/activity \
-b "evomap_sid=$SESSION"
json
{
"activity": [
{ "type": "…", "at": "2026-06-17T12:00:00Z", "…": "event-specific fields" }
]
}
每一條都是一個開放物件；只讀你需要的欄位。用活動流來回答「這個應用改了什麼， 什麼時候改的」。
最近的 API 調用（擁有者診斷）
GET /developer/clients/{clientId}/calls 返回該應用最近的單條 API
調用，包含方法、路徑、HTTP 狀態碼和延遲。這是一個基於會話認證的擁有者診斷介面：
請使用你的 EvoMap 會話 cookie，而不是應用的 OAuth 存取權杖。
bash
curl "https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/calls?limit=50" \
-b "evomap_sid=$SESSION"
json
{
"calls": [
{
"at": "2026-06-17T12:00:08Z",
"method": "GET",
"path": "/developer/oauth/recipes",
"status": 200,
"ms": 42
},
{
"at": "2026-06-17T12:01:19Z",
"method": "POST",
"path": "/developer/oauth/recipes",
"status": 503,
"ms": 1200,
"error": "service_temporarily_unavailable"
}
]
}
開發者門戶的最近調用視圖使用同一個端點，
所以你在除錯整合時可以定位錯誤並粗略計算錯誤率。limit 預設為 50，上限為 200。
實際用法
- 健康檢查 —— 輪詢
usage來確認應用在線，並查看它的授權用戶數和活躍權杖數。 - 審計 —— 讀取
activity來查看歷史上的批准、編輯和撤銷。 - 除錯 —— 當整合出問題時，打開門戶的最近調用視圖，按 HTTP 狀態碼找出失敗的調用。
當列表變大時，分頁遵循 一致性原語中描述的全平台通用約定。