조회¶
GET /api/v1/incidents/schedule/{schedule_uuid}/get
개요¶
인시던트 온콜 설정 및 현재 실제 온콜/대리 근무 요약을 조회합니다.
호출 전 및 사용 단계¶
현재 Key 권한은 routine.defaultAccess 또는 incidents.incidentsSchedule 중 하나를 충족해야 하며, 현재 워크스페이스에서 삭제되지 않은 스케줄만 대상으로 합니다. 대상이 없으면 400 IncidentsScheduleNotFound가 발생합니다. 목록의 content.data[].uuid를 사용하며, 인시던트 UUID 또는 정책 UUID를 전달하지 않습니다.
전체 스케줄 엔터티, notifyTargetsInfos, tagFilterInfos, 현재 원본/대리 근무 후 온콜 대상 및 onCallNext를 반환하며, 관리 목록의 effectiveTimeInfos/inEffectNotifyTargetsInfos 호환 필드는 포함하지 않습니다. 원본 규칙과 현재 온콜은 다릅니다. effectiveTime과 일중 근무 시간대, 로테이션 및 대리 근무는 모두 onCallNow에 영향을 줍니다. 대상 요약은 누락될 수 있으며, 요약이 없다고 해서 설정이 삭제된 것으로 간주해서는 안 됩니다. onCallNext는 향후 32개 날짜의 근무 시간대 시작점만 검색하며, 미래 스케줄 전체를 보장하지 않습니다.
조회 결과에는 프런트엔드에서 저장한 workTime/custom 로테이션/Agent 연결이 포함될 수 있습니다. 현재 공개 쓰기의 extend는 세 개의 선언된 키만 허용하므로, 상세의 모든 키를 그대로 다시 전송하여 수정해서는 안 됩니다. 공개 필드에 따라 재구성해야 하며, 수정 시 기존 근무 시간 의미가 변경될 수 있으므로 작업 전에 설정을 백업하고 캘린더 모드에서 검증하십시오.
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| schedule_uuid | string | Y | 현재 워크스페이스에서 삭제되지 않은 온콜 UUID이며, 정책 UUID/대리 근무 UUID/인시던트 UUID로 대체할 수 없습니다. null 허용: False 예시: incsch_example조회 또는 입력 방법: 온콜 목록의 일반 관리 모드에서 content.data[].uuid의 incsch_ UUID를 가져옵니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>조회 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
매개변수 추가 설명¶
요청은 이 페이지에 공개된 매개변수를 기준으로 합니다. 일중 start/end는 HH:MM이며, 유효 기간과 대리 근무 시간은 Unix 초입니다. 전체 필드, 값의 출처, 응답 분기 및 실패 처리는 아래를 참조하십시오.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/incidents/schedule/incsch_example/get' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | object | 온콜 엔터티 및 동적 요약입니다. |
| content.id | integer 또는 null | 데이터베이스 행 ID입니다. 비즈니스 식별에는 uuid를 사용하며, 제출 전 스냅샷은 null일 수 있습니다. |
| content.uuid | string | 온콜 UUID이며 incsch_ 접두사를 사용합니다. |
| content.status | integer | 데이터베이스 상태이며 일반적으로 0은 활성, 3은 삭제입니다. 인시던트의 open/working 상태가 아닙니다. |
| content.creator | string | 생성 주체이며 API Key는 일반적으로 wsak_ 리소스 UUID입니다. |
| content.updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.createAt | integer | Unix 초 생성 시간입니다. |
| content.updateAt | integer | Unix 초 최근 업데이트 시간입니다. |
| content.deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 -1입니다. |
| content.workspaceUUID | string | 소속 워크스페이스입니다. |
| content.name | string | 온콜 이름입니다. |
| content.timezone | string | IANA 시간대입니다. |
| content.start | string | 호환용 일일 근무 시작 시각(HH:MM)이며, 일정의 timezone에 따라 해석됩니다. 날짜나 Unix 시간이 아닙니다. |
| content.end | string | 호환용 일일 근무 종료 시각(HH:MM)입니다. 유효 날짜 경계는 extend.effectiveTime을 별도로 참조하십시오. |
| content.tagFilter | array<string> |
일치하는 태그 UUID 배열입니다. |
| content.tagFilter[] | string | 태그 UUID입니다. |
| content.dimensionFilter | string | 차원 일치 쿼리 표현식입니다. |
| content.notifyTargets | array<string> |
알림 대상 식별자 목록입니다. |
| content.notifyTargets[] | string | 계정/그룹/알림 대상 등의 대상 식별자입니다. |
| content.strategyConfig | array<object> |
에스컬레이션 정책 설정이며, 워크스페이스에 저장된 버전에 따라 조회됩니다. |
| content.strategyConfig[] | object | 하나의 설정 정책입니다. 인시던트 조회 API는 실행 미리보기를 펼치지 않습니다. |
| content.strategyConfig[].自定义字段 | JSON | 기타 저장된 정책 키이며, 고정된 실행 의미는 공개되지 않았습니다. |
| content.extend | object | 스케줄 확장 객체입니다. 공개 요청은 enableRotateNotification/rotationCycle/effectiveTime의 세 가지 선언된 키만 허용하며, 과거 데이터 조회 시 더 많은 키가 있을 수 있습니다. |
| content.extend.自定义字段 | JSON | 저장된 온콜 확장 키-값이며, 이 API로는 수정할 수 없습니다. |
| content.isDefault | boolean | 기본 온콜 여부입니다. |
| content.rotationUpdateAt | integer | 로테이션 기준점의 Unix 초입니다. 새로 생성 시 기본값은 -1이며 현재 계산은 생성 시간으로 자동 대체되지 않습니다. 첫 로테이션이 첫 번째 대상에서 시작된다는 보장은 없으며, 의미가 변경된 후 재설정할 수 있습니다. |
| content.agentUUIDs | array<string> |
확장에 연결된 Agent UUID 배열입니다. |
| content.agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.strategyConfig[].uuid | string | 정책 UUID입니다. |
| content.strategyConfig[].name | string | 정책 이름입니다. |
| content.strategyConfig[].strategy | array<object> |
해당 정책의 에스컬레이션 레벨 설정 배열입니다. |
| content.strategyConfig[].strategy[].level | integer | 레벨 순번이며 일반적으로 0부터 시작합니다. |
| content.strategyConfig[].strategy[].levelUpTime | integer | 인시던트 상태 트리거 시간부터의 에스컬레이션 대기 초 수입니다. |
| content.strategyConfig[].strategy[].incidentsLevel | array<string> |
적용되는 인시던트 등급 UUID 목록입니다. |
| content.strategyConfig[].strategy[].incidentsLevel[] | string | 하나의 등급 UUID입니다. |
| content.strategyConfig[].strategy[].incidentsStatus | array<string> |
적용되는 인시던트 상태 목록입니다(예: open/working). |
| content.strategyConfig[].strategy[].incidentsStatus[] | string | 하나의 인시던트 상태입니다. |
| content.strategyConfig[].strategy[].ifRepeatNotify | boolean | 반복 알림 여부입니다. |
| content.strategyConfig[].strategy[].repeatNotifyInterval | integer | 반복 알림 간격(초)입니다. |
| content.strategyConfig[].strategy[].notifyConfig | array<object> |
해당 레벨의 알림 설정 배열입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObjectType | string | 알림 대상 분류입니다(예: member/object/group). 저장된 버전에 따라 조회됩니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObject | array<string> |
알림 대상 식별자입니다. watchkeeper는 런타임의 현재 온콜 담당자를 의미하며 고정 계정 UUID가 아닙니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObject[] | string | 하나의 대상 계정/그룹/알림 대상 식별자 또는 watchkeeper입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyMethod | array<string> |
알림 방식입니다. 일반적으로 mobile은 전화, message는 SMS, email은 이메일입니다. 대상 채널은 대상 설정에 따라 실행됩니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyMethod[] | string | 하나의 알림 방식입니다. |
| content.extend.enableRotateNotification | boolean | 알림 대상 로테이션 여부입니다. |
| content.extend.rotationCycle | string | day/week/month/workDay/weekend/customDay/customWeek 중 하나이며, 과거 데이터에서는 생략될 수 있습니다. |
| content.extend.rotationInterval | integer | customDay의 로테이션 간격 일수(1~31), customWeek의 주 수(1~4)입니다. |
| content.extend.effectiveTime | object | 일정 유효 기간 설정입니다. |
| content.extend.effectiveTime.start | integer | 저장된 유효 시작 Unix 초이며, 기본값인 경우 시작 제한을 두지 않습니다. |
| content.extend.effectiveTime.end | integer | 저장된 유효 종료 Unix 초이며, 기본값인 경우 종료 제한을 두지 않습니다. |
| content.extend.workTime | object | 근무 시간 설정이며, 기본값인 경우 호환 start/end와 로테이션 주기에서 유추됩니다. |
| content.extend.workTime.mode | string | allDay는 종일, specificTimes는 지정 시간입니다. |
| content.extend.workTime.periods | array<object> |
지정 근무 시간대 배열입니다. |
| content.extend.workTime.periods[].weekdays | array<integer> |
적용 요일이며 1은 월요일부터 7은 일요일입니다. |
| content.extend.workTime.periods[].weekdays[] | integer | 1~7 중 하나입니다. |
| content.extend.workTime.periods[].start | string | 현지 날짜 기준 시작 HH:MM입니다. |
| content.extend.workTime.periods[].end | string | 현지 날짜 기준 종료 HH:MM입니다. |
| content.extend.agentUUIDs | array<string> |
연결된 Agent UUID이며, 엔터티에는 별도로 최상위 agentUUIDs 프로젝션이 있습니다. |
| content.extend.agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyType | JSON | 이전 편집기에서 유지될 수 있는 표시 분류입니다. 실행 체인은 주로 notifyObject/notifyMethod를 읽으며, 이를 기준으로 전송을 제어할 수 없습니다. |
| content.extend.effectiveTime.其他键 | JSON | 선언되지 않은 유효 기간 확장은 그대로 저장되며, 클라이언트는 start/end만 사용합니다. |
| content.rawWatchkeepers | array<string> |
임시 대리 근무가 적용되지 않은 현재 온콜 대상이며, []일 수 있습니다. |
| content.rawWatchkeepers[] | string | 원본 온콜 대상 식별자입니다. |
| content.effectiveWatchkeepers | array<string> |
현재 유효한 대리 근무를 적용한 후의 대상 식별자입니다. |
| content.effectiveWatchkeepers[] | string | 최종 대상 식별자이며, 팀/알림 대상일 수 있고 반드시 단일 계정은 아닙니다. |
| content.overrideInfos | array<object> |
현재 실제 적용된 대리 근무 엔터티 및 원본 대상/대리 근무 요약입니다. |
| content.onCallNext | array<object> |
향후 최대 32개 날짜의 근무 시간대 시작점에서 검색된 다음 근무 대상 요약입니다. 무한한 미래의 가장 가까운 이벤트를 보장하지 않으며, 근무 종료/시작 시간도 포함하지 않습니다. |
| content.notifyTargetsInfos | array<object> |
해석 가능한 알림 대상 요약입니다. onCallNow/effective는 현재 적용되는 값이며, inEffectNotifyTargetsInfos는 관리 목록의 이전 호환 별칭일 뿐입니다. |
| content.notifyTargetsInfos[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.notifyTargetsInfos[].status | integer | 주체 상태입니다. |
| content.notifyTargetsInfos[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.notifyTargetsInfos[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.notifyTargetsInfos[].name | string | 표시 이름입니다. |
| content.notifyTargetsInfos[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.notifyTargetsInfos[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.notifyTargetsInfos[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.notifyTargetsInfos[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.notifyTargetsInfos[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.notifyTargetsInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.notifyTargetsInfos[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.notifyTargetsInfos[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.notifyTargetsInfos[].groupMembers[].name | string | 표시 이름입니다. |
| content.notifyTargetsInfos[].groupMembers[].email | string | 이메일입니다. |
| content.notifyTargetsInfos[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.notifyTargetsInfos[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.rawWatchkeepersInfos | array<object> |
해석 가능한 알림 대상 요약입니다. onCallNow/effective는 현재 적용되는 값이며, inEffectNotifyTargetsInfos는 관리 목록의 이전 호환 별칭일 뿐입니다. |
| content.rawWatchkeepersInfos[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.rawWatchkeepersInfos[].status | integer | 주체 상태입니다. |
| content.rawWatchkeepersInfos[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.rawWatchkeepersInfos[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.rawWatchkeepersInfos[].name | string | 표시 이름입니다. |
| content.rawWatchkeepersInfos[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.rawWatchkeepersInfos[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.rawWatchkeepersInfos[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.rawWatchkeepersInfos[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.rawWatchkeepersInfos[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.rawWatchkeepersInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.rawWatchkeepersInfos[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.rawWatchkeepersInfos[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.rawWatchkeepersInfos[].groupMembers[].name | string | 표시 이름입니다. |
| content.rawWatchkeepersInfos[].groupMembers[].email | string | 이메일입니다. |
| content.rawWatchkeepersInfos[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.rawWatchkeepersInfos[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.effectiveWatchkeepersInfos | array<object> |
해석 가능한 알림 대상 요약입니다. onCallNow/effective는 현재 적용되는 값이며, inEffectNotifyTargetsInfos는 관리 목록의 이전 호환 별칭일 뿐입니다. |
| content.effectiveWatchkeepersInfos[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.effectiveWatchkeepersInfos[].status | integer | 주체 상태입니다. |
| content.effectiveWatchkeepersInfos[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.effectiveWatchkeepersInfos[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.effectiveWatchkeepersInfos[].name | string | 표시 이름입니다. |
| content.effectiveWatchkeepersInfos[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.effectiveWatchkeepersInfos[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.effectiveWatchkeepersInfos[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.effectiveWatchkeepersInfos[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.effectiveWatchkeepersInfos[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.effectiveWatchkeepersInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.effectiveWatchkeepersInfos[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.effectiveWatchkeepersInfos[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.effectiveWatchkeepersInfos[].groupMembers[].name | string | 표시 이름입니다. |
| content.effectiveWatchkeepersInfos[].groupMembers[].email | string | 이메일입니다. |
| content.effectiveWatchkeepersInfos[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.effectiveWatchkeepersInfos[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.onCallNow | array<object> |
해석 가능한 알림 대상 요약입니다. onCallNow/effective는 현재 적용되는 값이며, inEffectNotifyTargetsInfos는 관리 목록의 이전 호환 별칭일 뿐입니다. |
| content.onCallNow[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.onCallNow[].status | integer | 주체 상태입니다. |
| content.onCallNow[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.onCallNow[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.onCallNow[].name | string | 표시 이름입니다. |
| content.onCallNow[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.onCallNow[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.onCallNow[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.onCallNow[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.onCallNow[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.onCallNow[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.onCallNow[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.onCallNow[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.onCallNow[].groupMembers[].name | string | 표시 이름입니다. |
| content.onCallNow[].groupMembers[].email | string | 이메일입니다. |
| content.onCallNow[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.onCallNow[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.onCallNext[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.onCallNext[].status | integer | 주체 상태입니다. |
| content.onCallNext[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.onCallNext[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.onCallNext[].name | string | 표시 이름입니다. |
| content.onCallNext[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.onCallNext[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.onCallNext[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.onCallNext[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.onCallNext[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.onCallNext[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.onCallNext[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.onCallNext[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.onCallNext[].groupMembers[].name | string | 표시 이름입니다. |
| content.onCallNext[].groupMembers[].email | string | 이메일입니다. |
| content.onCallNext[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.onCallNext[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.inEffectNotifyTargetsInfos[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.inEffectNotifyTargetsInfos[].status | integer | 주체 상태입니다. |
| content.inEffectNotifyTargetsInfos[].wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.inEffectNotifyTargetsInfos[].username | string | 로그인 이름 또는 Key 이름입니다. |
| content.inEffectNotifyTargetsInfos[].name | string | 표시 이름입니다. |
| content.inEffectNotifyTargetsInfos[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.inEffectNotifyTargetsInfos[].email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.inEffectNotifyTargetsInfos[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.inEffectNotifyTargetsInfos[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.inEffectNotifyTargetsInfos[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.inEffectNotifyTargetsInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.inEffectNotifyTargetsInfos[].groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.inEffectNotifyTargetsInfos[].groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.inEffectNotifyTargetsInfos[].groupMembers[].name | string | 표시 이름입니다. |
| content.inEffectNotifyTargetsInfos[].groupMembers[].email | string | 이메일입니다. |
| content.inEffectNotifyTargetsInfos[].groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.inEffectNotifyTargetsInfos[].type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.overrideInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. |
| content.overrideInfos[].uuid | string | 해당 리소스 UUID이며, 팀은 group_, 대리 근무는 incschovr_입니다. |
| content.overrideInfos[].status | integer | 리소스 상태이며 일반적으로 0이고, 소프트 삭제된 3은 조회에서 제외됩니다. |
| content.overrideInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. |
| content.overrideInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.overrideInfos[].createAt | integer | Unix 초 생성 시간입니다. |
| content.overrideInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. |
| content.overrideInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. |
| content.overrideInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. |
| content.overrideInfos[].scheduleUUID | string | 소속 스케줄 UUID입니다. |
| content.overrideInfos[].replacedTarget | string | 대리 근무로 대체되는 대상 식별자입니다. |
| content.overrideInfos[].substituteTarget | string | 대리 근무 대상 식별자입니다. |
| content.overrideInfos[].startAt | integer | 대리 근무 시작 Unix 초입니다. |
| content.overrideInfos[].endAt | integer | 대리 근무 종료 Unix 초입니다. |
| content.overrideInfos[].timezone | string | 대리 근무 시간대입니다. |
| content.overrideInfos[].extend | object | 대리 근무 저장 확장입니다. |
| content.overrideInfos[].extend.自定义键 | JSON | 이전/유지 관리 확장 키입니다. |
| content.overrideInfos[].replacedTargetInfo | object 또는 null | 선택적 대상 요약이며, 해석할 수 없는 경우 null일 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.status | integer | 주체 상태입니다. |
| content.overrideInfos[].replacedTargetInfo.wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.overrideInfos[].replacedTargetInfo.username | string | 로그인 이름 또는 Key 이름입니다. |
| content.overrideInfos[].replacedTargetInfo.name | string | 표시 이름입니다. |
| content.overrideInfos[].replacedTargetInfo.iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.overrideInfos[].replacedTargetInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.overrideInfos[].replacedTargetInfo.id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].replacedTargetInfo.groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.overrideInfos[].replacedTargetInfo.groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.overrideInfos[].replacedTargetInfo.groupMembers[].name | string | 표시 이름입니다. |
| content.overrideInfos[].replacedTargetInfo.groupMembers[].email | string | 이메일입니다. |
| content.overrideInfos[].replacedTargetInfo.groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.overrideInfos[].replacedTargetInfo.type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.overrideInfos[].substituteTargetInfo | object 또는 null | 선택적 대상 요약이며, 해석할 수 없는 경우 null일 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.status | integer | 주체 상태입니다. |
| content.overrideInfos[].substituteTargetInfo.wsAccountStatus | integer | 현재 워크스페이스 멤버 관계 상태 요약입니다. |
| content.overrideInfos[].substituteTargetInfo.username | string | 로그인 이름 또는 Key 이름입니다. |
| content.overrideInfos[].substituteTargetInfo.name | string | 표시 이름입니다. |
| content.overrideInfos[].substituteTargetInfo.iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.email | string | 이메일입니다. Key 주체는 자신의 UUID일 수 있으며, 전달 가능 여부는 보장되지 않습니다. |
| content.overrideInfos[].substituteTargetInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.overrideInfos[].substituteTargetInfo.id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.createAt | integer | Unix 초 생성 시간입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. 팀 객체에만 해당합니다. |
| content.overrideInfos[].substituteTargetInfo.groupMembers | array<object> |
팀 요약에만 있는 유효하고 해석 가능한 멤버 목록입니다. |
| content.overrideInfos[].substituteTargetInfo.groupMembers[].uuid | string | 팀 멤버 계정 UUID입니다. |
| content.overrideInfos[].substituteTargetInfo.groupMembers[].name | string | 표시 이름입니다. |
| content.overrideInfos[].substituteTargetInfo.groupMembers[].email | string | 이메일입니다. |
| content.overrideInfos[].substituteTargetInfo.groupMembers[].acntWsNickname | string | 워크스페이스 닉네임입니다. |
| content.overrideInfos[].substituteTargetInfo.type | string | notify_ 알림 대상 유형에만 해당하며, 알림 자격 증명은 포함하지 않습니다. |
| content.tagFilterInfos | array<object> |
태그 전체 엔터티 요약이며, 목록/상세에 추가됩니다. |
| content.tagFilterInfos[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 식별에는 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. |
| content.tagFilterInfos[].uuid | string | 태그 UUID이며 tag_ 접두사를 사용합니다. |
| content.tagFilterInfos[].status | integer | 리소스 상태이며 일반적으로 0이고, 소프트 삭제된 3은 조회에서 제외됩니다. |
| content.tagFilterInfos[].creator | string | 생성 주체 UUID 또는 이전 시스템 주체입니다. |
| content.tagFilterInfos[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.tagFilterInfos[].createAt | integer | Unix 초 생성 시간입니다. |
| content.tagFilterInfos[].updateAt | integer | Unix 초 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. |
| content.tagFilterInfos[].deleteAt | integer | Unix 초 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. |
| content.tagFilterInfos[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. |
| content.tagFilterInfos[].name | string | 태그 이름입니다. |
| content.tagFilterInfos[].description | string | 설명입니다. |
| content.tagFilterInfos[].colour | string | 표시 색상입니다. |
| content.tagFilterInfos[].scope | array<string> |
범위 배열입니다: all/scene/monitor/dialing/security/infrastructure/catalog. 태그의 실제 정의를 기준으로 합니다. |
| content.tagFilterInfos[].scope[] | string | 하나의 실제 범위입니다. |
| content.declaration | object 또는 null | 현재 워크스페이스의 공개 선언입니다. |
{
"code": 200,
"content": {
"id": 7,
"uuid": "incsch_example",
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"workspaceUUID": "wksp_example",
"name": "支付服务值班",
"timezone": "Asia/Shanghai",
"start": "09:00",
"end": "18:00",
"tagFilter": [],
"dimensionFilter": "service:payment",
"notifyTargets": [
"acnt_example"
],
"strategyConfig": [],
"extend": {
"enableRotateNotification": false,
"agentUUIDs": []
},
"isDefault": false,
"rotationUpdateAt": -1,
"agentUUIDs": [],
"notifyTargetsInfos": [
{
"uuid": "acnt_example",
"name": "值班成员",
"email": "xxx@guance.com"
}
],
"rawWatchkeepers": [],
"effectiveWatchkeepers": [],
"rawWatchkeepersInfos": [],
"effectiveWatchkeepersInfos": [],
"onCallNow": [],
"onCallNext": [],
"overrideInfos": [],
"tagFilterInfos": [],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 400 | ft.IncidentsScheduleNotFound | 현재 워크스페이스에 삭제되지 않은 대상 스케줄이 없음 | 지정된 인시던트 온콜을 찾을 수 없습니다. | 관리 목록에서 uuid를 새로 고칩니다. |
| 406 | ft.ParameterValidationFailed | tagFilterInfos 조회 시 기존 태그 scope가 유효하지 않음 | invalid scope | 관리자에게 연결된 태그 scope를 확인하도록 요청하십시오. 이 오류는 경로 UUID/Query가 유효하지 않은 것이 아니므로 요청을 무작정 변경하지 마십시오. |
| 500 | ft.InternalServerError | 데이터베이스/기존 스케줄 정책, 알림 대상, 유효하지 않은 시간대/존재하지 않는 날짜 등의 처리되지 않은 예외 | 내부 오류 | 시간대, 날짜 및 기존 설정 형식을 확인하고 traceId를 보존한 뒤 백오프하십시오. 예외를 근거로 온콜 담당자가 없다고 판단하지 마십시오. |