CatQuest データ API リファレンス

🐾 CatQuest ページへ移動 →

CatQuest 画面は giip イシュー一覧 API(giipIssues) を読み取り、各イシューを猫カードとして描画します。本ドキュメントは、そのデータ元を API で直接取得 する方法と、画面の状態→猫マッピングを説明します。

ホスト: https://giipfaw.azurewebsites.net
認証: ヘッダー x-api-key にログインユーザーの AK（またはプロジェクトスコープ SK）。取得範囲はキーの csn（プロジェクト） に制限されます。
結果コード(RstVal) の規約は API 結果コード を参照してください。

イシュー一覧取得 — `giipIssues` GET

CatQuest がページ読み込み時に呼び出す読み取り API です。

curl "https://giipfaw.azurewebsites.net/api/giipIssues?csn=47" \
  -H "x-api-key: <YOUR_AK>"

リクエストパラメータ

名前	位置	必須	説明
`csn`	query	✅	取得するプロジェクト番号。CatQuest は現在選択中のプロジェクトの csn を自動で入れます。

レスポンス例

{
  "issues": [
    {
      "isn": 735,
      "title": "admin/catquest ユーザーガイド作成",
      "status": "READY",
      "regdate": "2026-07-24T08:54:00Z",
      "summary": "ガイドボタンの有効化",
      "last_comment_date": "2026-07-24T09:00:00Z",
      "blocked_by_isn": null,
      "blocked_by_title": null
    }
  ]
}

レスポンスフィールド（CatQuest が使用するもの）

フィールド	型	画面での用途
`isn`	number	イシュー番号(#isn バッジ)。どの猫を割り当てるかも `isn` で決まります。
`title`	string	カード上部の吹き出しタイトル
`status`	string	猫の動き（アニメーション）を決定 — 下記マッピング参照
`regdate`	string	登録日時(🐣)
`summary`	string	カード下部の要約（存在する場合のみ）
`last_comment_date`	string \| null	最終コメント日時(💬)、無ければ「コメント無し」
`blocked_by_isn`	number \| null	待機(blocked-by)バッジ — このイシューをブロックしている占有イシューの番号
`blocked_by_title`	string \| null	待機バッジのツールチップ（占有イシューのタイトル）

状態 → 猫の動きマッピング

CatQuest フロントが status 値を次のルールでアニメーションにマッピングします（サーバー値ではなく画面表現ルール）。

status	猫の状態	画像ファイルパターン
PENDING	playing	`/images/catquest/<cat>_playing.png`
READY	ready	`/images/catquest/<cat>_ready.png`
IN_PROGRESS	hunting	`/images/catquest/<cat>_hunting.png`
REVIEW	delivering	`/images/catquest/<cat>_delivering.png`
DONE	playing	`/images/catquest/<cat>_playing.png`

<cat> は isn % 8 で 8 種(mochi・sherlock・nimbus・pixel・cocoa・midnight・luna・leo)のいずれかが固定割り当てされます。

トラブルシューティング

症状	原因	解決
`401 Unauthorized`	`x-api-key` の欠落または期限切れ	有効な AK で再度呼び出すか再ログインします。
空の `issues: []`	その `csn` にイシューが無い	csn 値を確認するかイシューを登録します。
`csn` 無しで呼び出し	必須パラメータの欠落	必ず `?csn=<番号>` を含めます。

バージョン: 1.0 最終更新: 2026-07-24 ソースファイル: giipv3/public/help/api-catquest.ja.md

← Previousイシュー CatQuest Back to Overviewナレッジセンター