コンテンツにスキップ

操作記録一覧



GET /api/v1/error_track/{issue_id}/operate_record/list

概要

エラー処理の操作記録をページ単位で取得します。

呼び出し前の準備と使用手順

現在の Key には errorCenter.errorTrackQuery が必要で、現在のワークスペースに限ります。パスには実際のテレメトリ issue_id を指定します。親エラーの存在性は事前に必須検証されません。[] は記録なしを表す場合があり、これだけでテレメトリやメタデータが存在しないと判断することはできません。

データベース ID の降順で並び、デフォルトは 1 ページ 20 件です。操作種別と before/after は機械解析用、content はローカライズされた表示テキストです。担当者サマリーは解析可能な項目のみ返します。

content は {data,declaration} オブジェクトを保持し、pageInfo はレスポンスのトップレベルにあります。data 項目に共通宣言は自動追加されません。この読み取りはコメントを書き込まず、添付ファイルを紐付けず、通知も送信しません。履歴の extend=null や構造破損は 500 を引き起こす可能性があるため、traceId を保持して履歴記録を確認してください。

パスパラメータ

パラメータ名 型 必須 説明
issue_id string Y エラー集約の業務識別子で、そのまま渡します。refData.uuid(isset_)やコメント UUID ではありません。パスは URL エンコードで処理されます。詳細インターフェースでテレメトリの存在を検証しないでください。
例: 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 フィルタ条件を満たす候補/ローカル記録の総数。テレメトリ一覧は候補上限 10000 の影響を受けます。
pageInfo.pageIndex integer ページ番号。1 から開始します。
pageInfo.pageSize integer 今回の 1 ページあたりのリクエスト件数。
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 を保持してバックオフしてください。継続的に失敗する場合は、管理者に関連する履歴記録と設定の確認を依頼してください。

フィードバック

このページは役に立ちましたか?