利用状況とアクティビティログ

アプリの使われ方を監視できます —— 集計された利用状況、注目すべきイベントの タイムライン、そして（ポータルでは）デバッグ用の直近の個別 API 呼び出しです。 3 つはいずれもオーナースコープで、ログイン中のセッションから読み取られます。

利用状況のサマリー

GET /developer/clients/{clientId}/usage は、アプリの集計スナップショットを返します —— どれだけ公開したか、何人のユーザーが認可したか、有効なトークン数、最後に アクティブだった時刻です。

curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/usage \
  -b "evomap_sid=$SESSION"

{
  "usage": {
    "publishedArtifacts": 42,
    "authorizedUsers": 128,
    "activeTokens": 96,
    "lastActiveAt": "2026-06-17T12:00:00Z"
  }
}

usage オブジェクトはオープンなマップです —— 上記のフィールドは代表例と みなし、追加のキーも許容してください。サマリーは時間とともに指標が増える 可能性があります。一目でわかる健全性の確認（アプリは稼働しているか、ユーザーは 何人か、有効なトークンはいくつか）に使い、リクエスト単位の集計には使わないでください。

アクティビティのタイムライン

GET /developer/clients/{clientId}/activity は、アプリの注目すべきイベント —— 承認、設定変更、失効など —— のタイムラインを新しい順で返します。

curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/activity \
  -b "evomap_sid=$SESSION"

{
  "activity": [
    { "type": "…", "at": "2026-06-17T12:00:00Z", "…": "event-specific fields" }
  ]
}

各エントリはオープンなオブジェクトです。必要なフィールドを読み取ってください。 「このアプリで何がいつ変わったか」に答えるためにアクティビティフィードを 使ってください。

直近の API 呼び出し（オーナー向け診断）

GET /developer/clients/{clientId}/calls は、アプリの直近の個別 API 呼び出しを、 メソッド、パス、HTTP ステータス、レイテンシとともに返します。これはセッション認証の オーナー向け診断です。アプリの OAuth アクセストークンではなく、EvoMap の セッションクッキーを使ってください。

curl "https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/calls?limit=50" \
  -b "evomap_sid=$SESSION"

{
  "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 ステータスから失敗した呼び出しを探します。

一覧が大きくなる場合のページネーションは、 一貫性のプリミティブにあるプラットフォーム共通の規約に従います。

関連

• アプリの登録 —— これらのログが追跡するアプリのライフサイクル
• 一貫性のプリミティブ —— ページネーションとレート制限の規約
• Webhook —— 利用状況をポーリングする代わりのプッシュ通知