콘텐츠로 이동

작업 기록 목록



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를 보존하고 백오프하세요. 지속적으로 실패하면 관리자에게 관련 과거 기록과 구성을 확인하도록 요청하세요.

문서 평가

이 페이지가 도움이 되었나요?