메인 콘텐츠로 건너뛰기
POST
curl
케이스를 해결합니다. 케이스의 블루프린트가 4-eyes 검토용 검토자 블루프린트와 짝을 이루면, 케이스를 닫는 대신 해결 처리를 대기 상태로 설정합니다. 두 결과를 구분하려면 응답의 pending_resolution 필드를 확인하세요.

검토자 지정

4-eyes 검토 단계가 있는 블루프린트에서는 checker 필드에 해결 처리를 승인해야 할 멤버의 사용자 UUID를 보냅니다. 그러면 해당 멤버만 해결 처리를 승인하거나 거부할 수 있습니다. API 키를 포함한 다른 누구든 403을 받습니다. 해결 처리가 승인되거나 거부되거나, 증거가 바뀌어 새 검토를 위해 반환되기 전까지 케이스의 checker 필드에 해당 멤버가 표시됩니다. checker를 보내지 않으면 해결 처리는 검토자 블루프린트의 대기열에서 기다립니다. 멤버는 이 애플리케이션에 대한 케이스 액세스 권한이 있어야 하며, 해결 처리를 제출한 담당자일 수 없습니다. 검토자 단계가 없는 블루프린트에서 checker를 보내면 400이 반환됩니다.

4-eyes 검토가 필요한 해결에는 콘솔 멤버가 필요합니다

4-eyes 검토로 넘어가는 해결 처리는 API 키가 아니라 콘솔 멤버로 제출하세요. API 키로 제출한 해결 처리에는 기록된 작성자가 없으므로, 승인 및 승인 거부 요청은 지정된 검토자를 포함한 모든 호출자에게 403을 반환합니다.

액세스

케이스 endpoint에는 전체 액세스 API 키가 필요합니다. 제한된 액세스 권한의 키는 403을 받습니다.

관련 문서

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

organization_id
string<uuid>
필수

조직 UUID입니다.

application_id
string<uuid>
필수

애플리케이션 UUID입니다.

case_uuid
string<uuid>
필수

케이스 UUID.

예시:

"c1a5e000-0000-4000-8000-000000000001"

본문

application/json
resolution
enum<string>
필수
사용 가능한 옵션:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
note
string | null

블루프린트에 require_resolution_note가 설정된 경우 필수입니다.

checker
string<uuid> | null

상호 검토(Four-eyes) 블루프린트 전용입니다. 이 해결 처리를 승인해야 하는 멤버의 사용자 uuid입니다(케이스의 assigned_to.uuid 또는 검토 팀의 members[].user_id와 동일한 ID). 해당 멤버는 이 애플리케이션에 대한 케이스 접근 권한이 있어야 하며 해결 처리를 제출하는 담당자일 수 없습니다. 생략하거나 null을 전송하면 해결 처리가 검토자 대기열에 남겨집니다.

응답

해결되었거나 4-eyes 승인을 위해 스테이징되었습니다.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
사용 가능한 옵션:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
사용 가능한 옵션:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
사용 가능한 옵션:
LOW,
MEDIUM,
HIGH
source
enum<string>
사용 가능한 옵션:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

케이스가 연결된 단일 사용자 또는 기업입니다.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

케이스를 소유한 검토 팀이거나, 소유한 팀이 없는 경우 null입니다. 라우팅 규칙이 케이스를 해당 팀 중 하나에 배정할 때 라우팅에 의해 설정됩니다. PATCH .../cases/{case_uuid}/(team)로 변경하거나 비울 수 있습니다.

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

체커 블루프린트에서 승인 또는 거부 승인을 기다리며 4-eyes 해결 절차가 스테이징되는 동안에만 설정됩니다.

checker
object | null

대기 중인 결정을 승인하거나 거부하도록 지정된 멤버입니다. 4인 승인 결정이 지정된 검토자를 기다리는 동안에만 설정됩니다. 대기 중인 항목이 없거나, 대기 중인 결정이 검토자 대기열에서 대기 중이거나, 증거가 변경되어 결정이 승인, 거부 또는 새로운 검토를 위해 반환된 경우에는 null입니다.

metadata
object
blueprint
object
notes
object[]

최신 50개 메모입니다.

events
object[]

최신 100개 이벤트입니다.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
마지막 수정일 2026년 11월 7일