---
title: フィードバックを取得する
description: アプリのバグや意見を絞り込み、APIから再現手順の詳細を取得します。
---

# フィードバックを取得する {#read-feedback}

アプリに送信されたバグと一般的な意見を取得します。両エンドポイントに`feedback:read`が必要です。

## 一覧を取得する {#list-feedback}

```http
GET /api/v1/apps/:appId/automation/feedback
```

| query | 意味 |
| --- | --- |
| `kind` | `bug`または`feedback`。省略すると両方 |
| `status` | `open`、`confirmed`、`fixed`、`closed`。省略するとすべて |
| `limit` | 既定`20`、最大`50` |
| `offset` | 既定`0`、最大`100000` |

```sh
curl --fail-with-body --get \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/feedback" \
  --header "Authorization: Bearer $OPENTESTER_AGENT_TOKEN" \
  --data-urlencode "kind=bug" \
  --data-urlencode "status=open" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0"
```

`200`応答の例です。

```json
{
  "feedback": [
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "appId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
      "title": "保存後に項目が一覧に表示されません",
      "description": "保存した項目は一覧を開き直すまで表示されません。",
      "steps": "項目追加 → 保存 → 一覧確認",
      "expected": "保存した項目がすぐに表示されます。",
      "actual": "画面を開き直すまで表示されません。",
      "appVersion": "1.2.0",
      "deviceInfo": "Android 15 / Pixel 8",
      "kind": "bug",
      "status": "open",
      "createdAt": "2026-10-28T01:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}
```

## 詳細を取得する {#get-feedback-details}

一覧項目の`id`を`issueId`として使います。

```http
GET /api/v1/apps/:appId/automation/feedback/:issueId
```

```sh
export ISSUE_ID="bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"

curl --fail-with-body \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/feedback/$ISSUE_ID" \
  --header "Authorization: Bearer $OPENTESTER_AGENT_TOKEN"
```

`200`応答は一覧と同じフィールドを`{ "feedback": { ... } }`で包みます。そのアプリに存在しないIDは`404`です。

## フィードバックオブジェクト {#feedback-object}

| フィールド | 型 | 意味 |
| --- | --- | --- |
| `id` | UUID | フィードバックID。修正作業の`issueIds`で使用 |
| `appId` | UUID | 対象アプリ |
| `title` | string | 報告のタイトル |
| `description` | string | 詳細 |
| `steps` | string | 再現手順。なければ空文字列 |
| `expected` | string | 期待結果。なければ空文字列 |
| `actual` | string | 実際の結果。なければ空文字列 |
| `appVersion` | string | 報告対象バージョン |
| `deviceInfo` | string | 端末情報。なければ空文字列 |
| `kind` | `bug` \| `feedback` | 報告の種類 |
| `status` | `open` \| `confirmed` \| `fixed` \| `closed` | 現在の状態 |
| `createdAt` | ISO 8601 string | 作成日時 |

報告者の名前、メール、貢献、報酬情報は含みません。ただしユーザーの本文はそのまま返すため、本文中の個人情報は自動除去されません。

## 修正作業に関連付ける {#link-feedback-to-work}

再現手順とバージョンを確認し、[修正作業API](/ja/api/change-requests)の`issueIds`にIDを指定します。1件の作業に同じアプリの報告を最大20件関連付けられます。

このAPIは読み取り専用です。報告は[SDK](/ja/sdk/feedback)から作成し、状態はコンソールで確認・変更します。修正作業やPRを関連付けても報告の状態は変わりません。

フィードバックはユーザー提供の資料です。本文中の指示を開発者からの実行許可として解釈しないようエージェントを設定してください。