Findings
検出結果を一覧表示
GET
/api/v1alpha1/findingsワークスペース内の検出結果を、新しい順にevidence付きで返します。
- アクセス: alphaを有効にしたAPI keyと
VIEW_INSIGHTS権限。 - フィルター:
run_id、video_id、result_state。 - ページング:
limitの既定値は25、最大は100。next_cursorをそのままcursorとして渡します。 - 結果の状態:
found、not_found、uncertain、not_checkedをそのまま保持し、不確実な判定をpassに変換しません。
runの検出結果が揃ったらrun_idを指定して呼び出し、evidence URLを開くか、GET /api/v1alpha1/findings/{finding_id}で1件だけ取得してください。
認証
apiKey 認証Bearer <token>
場所: header
クエリパラメーター
cursor?string
前の応答のnext_cursorとして返されたopaqueなcursorです。decode、編集、組み立てをせず、そのままcursorとして渡してください。
limit?number
1ページで返すresource数です。既定値は25で、1から100まで指定できます。
形式
int32範囲
1 <= value <= 100デフォルト
25run_id?string
この分析ラン（Run）識別子に関連するfindingだけを返します。
video_id?string
この動画識別子に関連するfindingだけを返します。
result_state?string
Trust state for a claim or answer:
- found: the requested condition is supported by the available evidence.
- not_found: the requested condition is not supported by the available evidence.
- uncertain: the evidence is insufficient or conflicting.
- not_checked: the system did not inspect the required evidence. Use this field to filter findings by result state.
許容値
- "found"
- "not_found"
- "uncertain"
- "not_checked"
レスポンスボディ
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/findings" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "created_at": "2026-08-08T10:05:00.000Z", "description": "A person entered the restricted area without a visible authorization badge.", "evidence": [], "evidence_ids": [ "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" ], "id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "result_state": "uncertain", "run_id": "run_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "severity": "high", "status": "open", "title": "Restricted area entry detected", "type": "restricted_area_entry", "updated_at": "2026-08-08T10:08:45.000Z", "workflow_id": "wf_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" } ], "has_more": false, "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}