작업 기록 목록¶
GET /api/v1/error_track/{issue_id}/operate_record/list
개요¶
오류 처리 작업 기록을 페이지 단위로 읽습니다.
호출 전 및 사용 단계¶
현재 Key에는 errorCenter.errorTrackQuery 권한이 필요하며, 현재 워크스페이스에만 적용됩니다. 경로에는 실제 텔레메트리 issue_id를 사용합니다. 상위 오류의 존재 여부를 먼저 강제로 검증하지 않으며, []는 기록이 없음을 나타낼 수 있으므로 이를 근거로 텔레메트리 또는 메타데이터가 존재하지 않는다고 판단할 수 없습니다.
데이터베이스 ID 내림차순으로 정렬하며, 기본 페이지 크기는 20입니다. 작업 유형과 before/after는 기계적 파싱에 사용되며, content는 로컬라이즈된 표시 텍스트입니다. 담당자 요약은 파싱 가능한 항목만 반환합니다.
content는 {data,declaration} 객체를 유지하며, pageInfo는 응답 최상위에 있습니다. data 항목에는 공통 선언이 자동으로 추가되지 않습니다. 이 읽기 작업은 댓글을 작성하지 않고, 첨부 파일을 바인딩하지 않으며, 알림을 전송하지 않습니다. 과거 extend=null/구조 손상은 500 오류를 유발할 수 있으므로 traceId를 보존하여 과거 기록을 확인하시기 바랍니다.
라우트 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| issue_id | string | Y | 오류 집계 비즈니스 식별자이며 그대로 전달합니다. refData.uuid(isset_) 또는 댓글 UUID가 아닙니다. 경로는 URL 인코딩으로 처리됩니다. 상세 API로 텔레메트리 존재 여부를 검증하지 마세요. 예시: err_payment_timeout가져오기 또는 입력 방법: 오류 추적 목록에서 content.data[].issue_id를 가져오거나, 현재 워크스페이스 오류 센터 텔레메트리 기록의 issue_id를 사용합니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Query 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| pageIndex | integer | 선택적 정수이며, 생략 시 1입니다. 현재 이 ErrorTrack 진입점들은 양수/최대 제한을 선언하지 않았으므로 클라이언트는 양의 정수만 사용해야 합니다. null 허용: False 예시: 1가져오기 또는 입력 방법: 호출자가 페이지를 제어하며, 1부터 시작합니다. |
|
| pageSize | integer | 선택적 정수이며, 생략 시 20입니다. 선언된 상한이 없으므로 작은 페이지로 읽기를 권장하며, 0/음수를 전달하여 구현 동작에 의존해서는 안 됩니다. null 허용: False 예시: 20가져오기 또는 입력 방법: 호출자가 표시/일괄 처리 규모에 따라 선택합니다. |
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/error_track/err_payment_timeout/operate_record/list' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-urlencode pageIndex=1 \
--data-urlencode pageSize=20
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | object | 페이지 콘텐츠 객체입니다. |
| content.data | array<object> |
현재 페이지 기록이며, 일치 항목이 없으면 []입니다. |
| content.data[].id | integer 또는 null | 데이터베이스 행 ID이며 경로 위치 지정에 사용되지 않습니다. 제출 전 스냅샷은 null일 수 있습니다. |
| content.data[].uuid | string | 로컬 리소스 UUID입니다. 상세 메타데이터는 isset_, 작업 기록은 issetoper_, 댓글은 issetcomment_입니다. |
| content.data[].status | integer | 리소스 상태이며 일반적으로 0이고, 소프트 삭제된 3은 조회에서 제외됩니다. |
| content.data[].creator | string | 생성 주체입니다. 자동 초기화 메타데이터는 sys, Key로 기록된 주체는 wsak_입니다. |
| content.data[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.data[].createAt | integer | Unix 초 단위 생성 시간입니다. |
| content.data[].updateAt | integer | Unix 초 단위 업데이트 시간이며, 업데이트되지 않은 경우 -1일 수 있습니다. 동일 값 상태/담당자 업데이트는 반드시 갱신되지 않습니다. |
| content.data[].deleteAt | integer | Unix 초 단위 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다. |
| content.data[].workspaceUUID | string | 현재 Key가 속한 워크스페이스입니다. |
| content.data[].issueUUID | string | 로컬 메타데이터 isset_ UUID이며 경로 issue_id로 사용할 수 없습니다. |
| content.data[].issueID | string | 텔레메트리 issue_id 비즈니스 식별자입니다. |
| content.data[].content | string | 로컬라이즈된 작업 문구입니다. |
| content.data[].extend | object 또는 null | 시스템 작업 확장 또는 일반 댓글 비즈니스 확장이며, 과거 비정상 값은 읽기 시 500 오류를 유발할 수 있습니다. |
| content.data[].extend.operate_type | string | 시스템 작업 유형: assigner_update 또는 status_update. 일반 댓글은 없을 수 있습니다. |
| content.data[].extend.operator | string | 시스템 작업 주체 UUID입니다. |
| content.data[].extend.before | string 또는 array<string> |
status_update인 경우 이전 상태 문자열, assigner_update인 경우 이전 담당자 배열입니다. |
| content.data[].extend.after | string 또는 array<string> |
status_update인 경우 새 상태 문자열, assigner_update인 경우 새 담당자 배열입니다. |
| content.data[].extend.operator_info | object | 선택적 작업 주체 요약이며, 일치 항목이 없으면 {}입니다. |
| content.data[].extend.before_info | array<object> |
assigner_update의 이전 담당자 중 파싱 가능한 요약이며, 팀은 uuid/name만 포함합니다. |
| content.data[].extend.after_info | array<object> |
assigner_update의 새 담당자 중 파싱 가능한 요약입니다. |
| content.data[].extend.operator_info.uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.status | integer | 주체 상태입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.wsAccountStatus | integer | 현재 워크스페이스 구성원 관계 상태 요약입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.username | string | 로그인 이름 또는 Key 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.name | string | 표시 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.email | string | 이메일이며, Key 주체는 자신의 UUID일 수 있고 전달 가능성은 보장되지 않습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.operator_info.acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].status | integer | 주체 상태입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].wsAccountStatus | integer | 현재 워크스페이스 구성원 관계 상태 요약입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].username | string | 로그인 이름 또는 Key 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].name | string | 표시 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].email | string | 이메일이며, Key 주체는 자신의 UUID일 수 있고 전달 가능성은 보장되지 않습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.before_info[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].status | integer | 주체 상태입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].wsAccountStatus | integer | 현재 워크스페이스 구성원 관계 상태 요약입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].username | string | 로그인 이름 또는 Key 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].name | string | 표시 이름입니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].email | string | 이메일이며, Key 주체는 자신의 UUID일 수 있고 전달 가능성은 보장되지 않습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].extend.after_info[].acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. 계정 필드는 생략될 수 있고, 팀은 uuid/name만 가집니다. |
| content.data[].creatorInfo | object | 주체 요약이며, 일치 항목이 없으면 {}이고 시스템 주체는 필드가 적을 수 있습니다. |
| content.data[].creatorInfo.uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.data[].creatorInfo.status | integer | 주체 상태입니다. |
| content.data[].creatorInfo.wsAccountStatus | integer | 현재 워크스페이스 구성원 관계 상태 요약입니다. |
| content.data[].creatorInfo.username | string | 로그인 이름 또는 Key 이름입니다. |
| content.data[].creatorInfo.name | string | 표시 이름입니다. |
| content.data[].creatorInfo.iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.data[].creatorInfo.email | string | 이메일이며, Key 주체는 자신의 UUID일 수 있고 전달 가능성은 보장되지 않습니다. |
| content.data[].creatorInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.data[].creatorInfo.countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.data[].creatorInfo.acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo | object | 주체 요약이며, 일치 항목이 없으면 {}이고 시스템 주체는 필드가 적을 수 있습니다. |
| content.data[].updatorInfo.uuid | string | 주체 UUID이며 계정, Key 또는 시스템 식별자일 수 있습니다. |
| content.data[].updatorInfo.status | integer | 주체 상태입니다. |
| content.data[].updatorInfo.wsAccountStatus | integer | 현재 워크스페이스 구성원 관계 상태 요약입니다. |
| content.data[].updatorInfo.username | string | 로그인 이름 또는 Key 이름입니다. |
| content.data[].updatorInfo.name | string | 표시 이름입니다. |
| content.data[].updatorInfo.iconUrl | string | 아바타 URL이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo.email | string | 이메일이며, Key 주체는 자신의 UUID일 수 있고 전달 가능성은 보장되지 않습니다. |
| content.data[].updatorInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo.countryCode | string | 전화 국가 코드이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo.acntWsNickname | string | 현재 워크스페이스 닉네임이며 비어 있을 수 있습니다. |
| pageInfo | object | 페이지 메타 정보이며, OpenAPI에서는 최상위에 있습니다. content는 객체를 유지합니다. |
| pageInfo.count | integer | 현재 페이지의 실제 건수입니다. |
| pageInfo.totalCount | integer | 필터를 만족하는 후보/로컬 기록 총 건수이며, 텔레메트리 목록은 후보 10,000건 상한이 적용됩니다. |
| pageInfo.pageIndex | integer | 페이지 번호이며 1부터 시작합니다. |
| pageInfo.pageSize | integer | 이번 요청의 페이지당 요청 수입니다. |
| content.declaration | object 또는 null | 현재 워크스페이스 공통 선언이며, content 상위 객체에만 추가되고 data 항목에 재귀적으로 추가되지 않습니다. |
{
"code": 200,
"content": {
"data": [
{
"id": 7,
"uuid": "issetoper_example",
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"workspaceUUID": "wksp_example",
"issueUUID": "isset_example",
"issueID": "err_payment_timeout",
"extend": {
"operate_type": "status_update",
"operator": "wsak_example",
"before": "Triage",
"after": "Working",
"operator_info": {}
},
"content": "상태가 Triage에서 Working으로 변경되었습니다",
"creatorInfo": {},
"updatorInfo": {}
}
],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE",
"pageInfo": {
"count": 1,
"totalCount": 1,
"pageIndex": 1,
"pageSize": 20
}
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방식 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 선언되지 않은 Query 매개변수를 사용하거나 매개변수가 규칙을 위반한 경우 | 매개변수 파싱 실패 | Query 매개변수 표 및 예시를 확인하세요. |
| 500 | ft.InternalServerError | 데이터베이스 읽기, 과거 JSON 구조 또는 연관 요약 구성에서 처리되지 않은 예외가 발생한 경우 | 내부 오류 | traceId를 보존하고 백오프하세요. 지속적으로 실패하면 관리자에게 관련 과거 기록과 구성을 확인하도록 요청하세요. |