アナリティクスエンドポイント
分析データをプログラムから取得できます。すべての分析エンドポイントは JWT 認証を必要とし、ちょうど 1 つの API キーに属し、期間を `days`(1〜365、既定値 30)で受け取ります。`form_key` を指定すると単一のフォームに絞り込めます。
Base URL: https://api.silentshield.io
GET/api/v1/keys/{id}/analytics/summary
指定期間のリクエスト、判定結果、トレンドの概要を取得します。
Parameters: ?days=30&form_key=contact
Response:
{"period_days": 30, "overview": {...}, "timeline": [...], "verdicts": [...], "pages": [...], "devices": [...], "browsers": [...], "reasons": [...], "blocks": {...}, "score_distribution": [...]}GET/api/v1/keys/{id}/analytics/timeline
時間間隔(時間、日、週)ごとにグループ化されたリクエスト数を取得します。
Parameters: ?days=7&form_key=contact
Response:
[{"date": "2025-01-01", "total": 1800, "human": 1620, "suspicious": 110, "bot": 70}, ...]GET/api/v1/keys/{id}/analytics/verdicts
スコア付きの詳細な判定結果分布を取得します。
Parameters: ?days=30&form_key=contact
Response:
{"distribution": {"human": 89.6, "suspicious": 6.4, "bot": 4.0}, "avgScore": 0.82}GET/api/v1/keys/{id}/analytics/devices
デバイスおよびブラウザの内訳を取得します。
Parameters: ?days=30&form_key=contact
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}}