Findings
検出結果を取得
GET
/api/v1alpha1/findings/{finding_id}1件の検出結果を、そのevidenceとあわせて返します。
- アクセス: alphaを有効にしたAPI keyと
VIEW_INSIGHTS権限。 - 応答:
result_state、検出のもとになったルール、metadataに記録されたlimitations、設定されている場合はreview fieldを保持します。 - evidence: clip URL、thumbnail URL、transcript span、OCR span、scene descriptionを含む場合があります。
- 見つからない場合: 他のワークスペースの検出結果は、存在しない場合と意図的に区別できません。
利用側のproductでaccept、dismiss、escalateを判断する前に、evidenceでclaimを確認してください。
認証
apiKey 認証Bearer <token>
場所: header
パスパラメーター
finding_id*string
findingの識別子です。GET /api/v1alpha1/findingsの data[].id で返ります。
レスポンスボディ
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/finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "created_at": "2026-08-08T10:05:00.000Z", "description": "A person entered the restricted area without a visible authorization badge.", "evidence": [ { "clip_url": "https://cdn.example.test/media/vid_0190b5d4/clip-42.mp4", "end_time": 49.75, "finding_id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "id": "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "start_time": 42.25, "video_id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" } ], "evidence_ids": [ "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" ], "id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "metadata": { "extraction_method": "", "frame_number": 0, "limitations": [ "" ], "quality": "" }, "result_state": "uncertain", "reviewed_at": "2026-08-08T10:08:45.000Z", "reviewed_by": "user_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "rule_id": "rule_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "rule_reference": "SEC-04", "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", "video_id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "workflow_id": "wf_0190b5d4-7e1f-7a2b-9c3d-1234567890ab"}