메인 콘텐츠로 건너뛰기
GET
curl
애플리케이션의 케이스를 나열합니다. 기본적으로 최신순으로 표시됩니다. 콘솔의 케이스 목록에서 사용할 수 있는 모든 필터와 정렬 옵션은 쿼리 파라미터로 제공됩니다. 여기에는 주체, 태그, 케이스 번호, 연결된 세션 또는 거래 ID를 대상으로 하는 전체 텍스트 검색 search가 포함됩니다. 각 케이스에는 케이스를 소유한 team, 보류 중인 2인 승인 절차의 지정된 checker, 그리고 주체의 country와 portrait도 포함됩니다.

액세스

케이스 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입니다.

쿼리 매개변수

limit
integer
기본값:50

페이지 크기입니다. 기본값은 50입니다.

필수 범위: x >= 1
offset
integer
기본값:0

첫 번째 레코드의 0부터 시작하는 오프셋입니다.

필수 범위: x >= 0
status__in
string

포함할 쉼표로 구분된 상태입니다(예: OPEN,AWAITING_USER).

priority
string

포함할 쉼표로 구분된 우선순위입니다.

source__in
string

포함할 쉼표로 구분된 소스입니다.

blueprint
string<uuid>

이 블루프린트의 케이스로 필터링합니다.

assigned_to
string<uuid>

이 사용자에게 배정된 케이스로 필터링합니다.

unassigned
boolean

할당되지 않은 케이스의 경우 true, 할당된 케이스의 경우 false입니다.

tag
string

이 정확한 태그가 지정된 케이스로 필터링합니다.

제목, case_number, 태그, 대상자 성명/UUID/외부 ID, 연결된 세션 UUID 또는 연결된 거래 UUID와 일치합니다.

date_from
string<date>

생성 일시 하한값(해당 값 포함).

date_to
string<date>

생성 일시 상한값(해당 값 포함).

due_before
string<date-time>

due_at 상한값입니다.

overdue
boolean

기한이 지난 open/awaiting-user 케이스만 반환하려면 true입니다.

ordering
enum<string>
기본값:-created_at

정렬 순서입니다. due_at은 null 값을 마지막으로 정렬합니다.

사용 가능한 옵션:
created_at,
-created_at,
due_at,
-due_at

응답

200 - application/json

페이지 단위로 제공되는 케이스 목록입니다.

count
integer

일치하는 행의 수입니다. 최대 100개까지는 정확하며, 성능상의 이유로 100개를 초과하면 100으로 제한됩니다. 마지막 페이지를 감지하려면 next가 null인지 확인하십시오.

next
string | null

다음 페이지의 절대 URL이거나 null입니다.

previous
string | null

이전 페이지의 절대 URL이거나 null입니다.

results
object[]
마지막 수정일 2026년 11월 7일