목록¶
GET /api/v1/incidents/schedule/list
개요¶
Query 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| incidentsScheduleUUIDs | commaArray | 인시던트 일정 UUID 목록 Null 허용: False |
|
| mySchedule | string | 내 일정 보기, 기본 false: 모든 일정 보기 Null 허용: True 선택 값: ['true', 'false'] |
|
| scheduleCalendar | string | 일정 캘린더, 기본 false: 일정 관리 보기 Null 허용: True 선택 값: ['true', 'false'] |
|
| scTimezone | string | 일정 캘린더 조회 시 시간대, 기본 Asia/Shanghai 예시: Asia/Shanghai Null 허용: False 최대 길이: 48 |
|
| scDateRange | string | 일정 캘린더 조회 시 날짜 범위, 기본 조회 당일만 예시: 2024/06/22~2024/07/06 Null 허용: False 빈 문자열 허용: False 최대 길이: 48 |
|
| search | string | 일정 이름 검색 Null 허용: True |
|
| pageIndex | integer | 페이지 번호 Null 허용: False 예시: 1 $minValue: 1 |
|
| pageSize | integer | 페이지당 반환 개수 Null 허용: False 예시: 10 $minValue: 1 $maxValue: 100 |
매개변수 추가 설명¶
scheduleCalendar=true인 경우, scheduleCalendarInfos[date][]는 임시 대체 계산 후의 실제 당직자를 반환하며, 더 이상 원래 당직자와 동일한 수준의 overrideInfo 호환 구조를 반환하지 않습니다.
각 캘린더 배열 항목의 주체 계정 필드는 해당 시간 조각의 실제 당직자를 나타내며, 다음을 포함합니다:
scheduleUUID: 해당 시간 조각이 속한 당직 설정 UUID입니다.scheduleTimeRange: 임시 대체 시작 및 종료 경계를 기준으로 분할된 실제 당직 시간 조각입니다.overrideInfo: 일치하는 전체 임시 대체 관계입니다. 일치하지 않는 경우null입니다.
대체 관계의 substituteTargetInfo는 배열 항목의 주체 계정 정보와 동일하며, replacedTargetInfo는 대체 전 원래 당직자입니다. 서로 다른 대체 관계는 잘못 병합되지 않습니다. 동일한 관계의 여러 불연속 시간 조각은 동일한 scheduleTimeRange 배열로 병합될 수 있습니다.
캘린더 모드 예시:
{
"scheduleCalendarInfos": {
"2026/08/16": [
{
"uuid": "acnt_substitute",
"name": "Bob",
"email": "xxx@guance.com",
"scheduleUUID": "incsch_xxx",
"scheduleTimeRange": [[1786838400, 1786856400]],
"overrideInfo": {
"uuid": "incschovr_xxx",
"scheduleUUID": "incsch_xxx",
"replacedTarget": "acnt_original",
"substituteTarget": "acnt_substitute",
"startAt": 1786838400,
"endAt": 1786856400,
"timezone": "Asia/Shanghai",
"replacedTargetInfo": {
"uuid": "acnt_original",
"name": "Alice",
"email": "xxx@guance.com"
},
"substituteTargetInfo": {
"uuid": "acnt_substitute",
"name": "Bob",
"email": "xxx@guance.com"
}
}
}
]
},
"scheduleCalendarUpdateInfos": {},
"totalCount": 1,
"myScheduleCount": 1,
"totalScheduleCount": 1
}
Front 동일 경로 캘린더 인터페이스는 계속해서 원래 당직자와 동일한 수준의 overrideInfo 호환 구조를 반환합니다. OpenAPI 일반 목록, 상세, 쓰기 인터페이스 및 AIAPI 당직 목록은 영향을 받지 않습니다.
요청 예시¶
curl 'https://openapi.guance.com/api/v1/incidents/schedule/list?pageIndex=1&pageSize=20' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--compressed
응답¶
{
"code": 200,
"content": {
"data": [
{
"workspaceUUID": "wksp_xxxx",
"name": "default",
"timezone": "Asia/Shanghai",
"start": "00:00",
"end": "23:59",
"tagFilter": [],
"dimensionFilter": "",
"notifyTargets": [],
"strategyConfig": [],
"extend": {
"rotationCycle": "day",
"enableRotateNotification": false
},
"isDefault": true,
"rotationUpdateAt": 1768803347,
"id": 6952,
"uuid": "incsch_xxx",
"status": 0,
"creator": "SYS",
"updator": "acnt_xxx",
"createAt": 1768803072,
"deleteAt": -1,
"updateAt": 1768803347,
"inEffectNotifyTargetsInfos": [],
"notifyTargetsInfos": [],
"effectiveTimeInfos": {
"timeStr": "",
"expired": false
},
"tagFilterInfos": []
}
],
"pageInfo": {
"pageIndex": 1,
"pageSize": 20,
"count": 1,
"totalCount": 1
},
"myScheduleCount": 1,
"totalScheduleCount": 1
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "xxx"
}