SilentShield

アナリティクスエンドポイント

アナリティクスデータをプログラムで照会できます。すべてのアナリティクスエンドポイントにはJWT認証が必要で、日付範囲フィルタリングをサポートしています。

Base URL: https://api.silentshield.io

GET/api/v1/analytics/summary

指定期間のリクエスト、判定結果、トレンドの概要を取得します。

Parameters: ?keyId=key_abc&from=2025-01-01&to=2025-01-31

Response:

{"totalRequests": 12500, "humans": 11200, "suspicious": 800, "bots": 500, "botRate": 0.04, "trend": "+12%"}

GET/api/v1/analytics/timeline

時間間隔（時間、日、週）ごとにグループ化されたリクエスト数を取得します。

Parameters: ?keyId=key_abc&from=2025-01-01&to=2025-01-07&interval=day

Response:

[{"date": "2025-01-01", "total": 1800, "human": 1620, "suspicious": 110, "bot": 70}, ...]

GET/api/v1/analytics/verdicts

スコア付きの詳細な判定結果分布を取得します。

Parameters: ?keyId=key_abc&from=2025-01-01&to=2025-01-31

Response:

{"distribution": {"human": 89.6, "suspicious": 6.4, "bot": 4.0}, "avgScore": 0.82}

GET/api/v1/analytics/devices

デバイスおよびブラウザの内訳を取得します。

Parameters: ?keyId=key_abc&from=2025-01-01&to=2025-01-31

Response:

{"devices": {"desktop": 65.2, "mobile": 28.1, "tablet": 4.2, "unknown": 2.5}, "browsers": {"Chrome": 58.3, "Safari": 22.1, "Firefox": 12.4, "Edge": 5.8, "Other": 1.4}}