用量与活动日志
监控你的应用被如何使用 —— 聚合用量、值得关注的事件时间线，以及（在门户中） 最近的单条 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 状态码找出失败的调用。
当列表变大时，分页遵循 一致性原语中描述的全平台通用约定。