🛡 守 Mamori

認証

参加者向けエンドポイントは、HTTPヘッダー X-Mamori-Key: mk_...(またはクエリ ?key=)で認証します。公開エンドポイントは認証不要です。レート制限: 投稿 30回/時・キー、読取 120回/時・IP。超過時は 429。

公開(認証不要)

エンドポイント内容
GET /api/latest最新の脅威インテル(TLP:CLEAR・JSON)
GET /api/stixSTIX 2.1 バンドル(MISP/OpenCTIにインポート可)
GET /api/stats公開カウンタ(参加組織数・観測数・インテル件数)
GET /api/sample-report対策下書きレポートの実物(Markdown)
GET /api/observationsキーなし: TLP:CLEAR の観測のみ
GET /healthz / /api/refresh-status稼働確認・最終リフレッシュ状況

参加者(キー必須)

エンドポイント内容
GET /api/whoamiキーの有効性確認。org_hash と tlp_max を返す
GET /api/observations自分の tlp_max 以下の観測(直近200件・90日保持)
POST /api/observations観測を投稿。JSON: {"type": "...", "pattern": "...", "tlp": "CLEAR|GREEN|AMBER"}。TLP:RED は拒否(400)。成功時 201

エラー形式

すべて {"error": "..."} 形式のJSON。400=形式不正、401/403=キー不正、404=なし、429=レート制限。

ブラウザからの投稿は /post、状態確認は /my でも行えます。