フィードバックを取得する

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

一覧を取得する

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

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

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応答の例です。

{
  "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
}

詳細を取得する

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

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

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です。

フィードバックオブジェクト

フィールド	型	意味
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	作成日時

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

修正作業に関連付ける

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

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

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