콘텐츠로 이동

동일 조직 워크스페이스 간략 목록 조회¶

POST /api/v1/workspace/same_org/list

개요¶

현재 DF-API-KEY가 속한 워크스페이스와 동일한 조직의 워크스페이스 간략 정보 목록을 조회합니다.

본문 요청 매개변수¶

매개변수명	유형	필수	설명
workspaceUUIDs	array		선택 사항. 워크스페이스 UUID 목록으로 필터링합니다. 빈 배열은 미전달과 동일합니다. 최대 개수는 SameOrgTraceQuerySet.maxWorkspaceCount를 초과할 수 없으며, 단일 UUID 최대 길이는 128입니다. 빈 값 허용: True
pageSize	integer		선택 사항. 페이지당 항목 수입니다. 기본값은 20, 최대값은 100이며, SameOrgTraceQuerySet.workspaceListPageSizeMax 설정에 따라 제어됩니다. 빈 값 허용: True
beforeWorkspaceId	integer		선택 사항. 이전 페이지에서 반환된 nextBeforeWorkspaceId입니다. 전달 시 Workspace.id가 이 값보다 작은 레코드만 반환합니다. 빈 값 허용: True

매개변수 추가 설명¶

본 API는 SameOrgTraceQuerySet.enable 설정의 영향을 받지 않으며, 동일 조직 내 trace 조회를 위한 대상 워크스페이스 선택을 지원하는 용도로만 사용됩니다.

workspaceId는 본 API의 페이지네이션에만 사용됩니다.
이후 trace 조회는 workspaceUUID를 사용해야 합니다.
본 API는 DQL 쿼리를 실행하지 않으며, Kodo의 최종 동일 조직 검증을 대체하지 않습니다.

응답¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "workspaceId": 12345,
                "workspaceUUID": "wksp_x",
                "workspaceName": "Demo Workspace",
                "versionType": "pay"
            }
        ],
        "pageInfo": {
            "pageSize": 20,
            "hasMore": true,
            "nextBeforeWorkspaceId": 12345
        }
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}