操作記録一覧¶
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 を保持してバックオフしてください。継続的に失敗する場合は、管理者に関連する履歴記録と設定の確認を依頼してください。 |