GameGene

GameGene が記録している設計上の遺伝子 (gene) を全件返す。各 gene には定義文と、その gene を持つ作品の slug が並ぶ。ページングしない — 設計空間の全体を一度に渡すための tool である。

gamegene_genes

読者の数で並べた上位を返す。target と by の組み合わせ: game (views / favorites / known)、gene (views / favorites)、claim (views — 主張は画面では «工夫» と呼ぶ)、trivia (views / likes)、rumor (views)、person (views — 直近 days 日に読んだ読者の数)。views は直近 days 日 (既定30日、日本時間の日) の閲覧の合計。favorites・known・likes は今の人数で、days は効かない (応答の days が null)。known は «見て知った» か «遊んだ» と記録した人の数 (知りたい は数えない)。使えない組み合わせは error を返す。closed が true の行 (伏せる噂・ネタバレのトリビア) は label に本文を出さない。数は集計だけで、誰が見たかは含まない。**STG・公開前の数は小さく、運営の確認の閲覧も混ざる** — 傾向の断定に使わないこと。

gamegene_popular

**いま接続している読者本人** の GameGene の記録を返す (他の読者の記録は読めない)。sections で絞れ、省くと全部: known (知っている作品 — how は want = 知りたい / watched = 見て知った / played = 遊んだ)、favorites (お気に入りの作品・gene・ジャンル・ノート)、history (直近 historyDays 日 (既定90日) に開いた作品と日・読んだ人物・初めて開いた工夫 / トリビア / 噂)、likes («興味深い» を付けたトリビア)、requests (本人が出した依頼 — 要望・情報提供も含む。reply は完了・見送りの行だけ)、notebooks (本人のノートの一覧 — 非公開も含む。本文は含まない)。各一覧は新しい順に最大200件で、応答の大きさにも上限がある。切った一覧は cut に名前が入る (続きは取れない)。knownTotals は知っている作品の総数 (一覧を切っても正しい)。履歴・いいねの行の closed / spoiler が true なら、中身は読者が望むまで伏せること。«知っている» の数は watched と played を数える (want は数えない)。

gamegene_me

作品または gene を指定して、記録されている主張を返す。**複数の作品・gene は gameSlugs / geneSlugs (各最大30) で1回にまとめて引く** — 1件ずつ呼ばない。作品と gene を両方渡すと、どちらかに当たる主張を全部返す (和)。各主張の subjectGameSlug / geneSlug でどれのものか分かる。無い slug は unknownSlugs に入る (在るものだけで引く)。本文を持つのでページングする — nextOffset が null でなければ続きが在る。件数と本文の合計文字数の両方で打ち切り、予算で切れたときは truncatedByBudget が true になる。claimType は invention / integration / refinement / transfer / inversion / scaling / popularization の7種で、transfer と inversion と invention が «新しい組み合わせ» を記録した行である。各主張には evidence が並ぶ — 出典の題・URL・archiveUrl・種別と、その根拠が主張を支持するか反論するか (stance)、どれだけ直接に支えるか (directness)。根拠の抜粋と要約は含まない (応答が膨らむため)。出典を持たない主張では空配列になる。

gamegene_claims

人物 (作り手) 1人について返す: 名前・別名、関わった作品と役割 (年の順)、その人が語った・書いた出典 (インタビュー等)、人物についてのトリビア、数 (stats.readers — 人物ページを読んだ読者の数、累計。読み直しは数えない)。slug は gamegene_search か gamegene_game の credits で得る。無い slug は null。

gamegene_person

作品1本について、記録している全部を返す: 概要・開発・発売・原作機種・別名、関係者 (credits — 人物の slug つき)、受賞とノミネート、いま遊べる場所 (availability)、動画、シリーズ、評価・評判 (digest — 出典つきでまとめた本文、Markdown。body はネタバレなしの前半、spoilerPart はネタバレを含む後半)、トリビア (出典と «いいね» の数つき)、噂、数 (stats — 閲覧数の直近7日・30日・累計、お気に入りの人数、既知 (知りたい / 見て知った / 遊んだ) の人数、トリビアのいいねの合計)。主張は claimCount の件数だけを返す — 本文は gamegene_claims に gameSlug を渡して読む。無い slug は null。トリビアは本文の予算で切ることがあり、そのとき truncatedByBudget が true (triviaTotal が総数)。spoiler が true のトリビアと closed が true の噂はネタバレ・解釈を含む — 読者が望むまで中身を伏せて伝えること。受賞 (awards) は網羅ではない — 調べた賞 (checkedAwards) の中での結果だけで、awards が空でも «受賞歴なし» と答えないこと。spoilerPart も読者が望むまで伏せること。数は集計だけで、誰が見たかは含まない。

gamegene_game

GameGene が記録している作品を全件返す。各作品には題・ジャンル・年と、その作品が持つ gene の slug が並ぶ。ページングしない — gamegene_genes と対で、設計空間の全体を一度に渡す。

gamegene_games

公開ノート1冊を本文まで返す。**下書きのノートは ID を指定しても返らない** — その場合は null が返る (存在しない ID と同じ)。本文が長いと entries を途中で打ち切ることがある — そのとき truncatedByBudget が true になり、nextEntryOffset に続きの位置が入る。続きを読むには、その値を entryOffset にそのまま渡してもう一度呼ぶ。nextEntryOffset が null なら続きは無い。entryCount は entries の返却件数ではなく、そのノートの entries 総数。

gamegene_notebook

読者が公開している研究ノートの一覧を返す。ID・題・要約と、そのノートが対象にしているもの (targets — 作品 / gene / ジャンルの slug) が並ぶ。**本文は含まない** — 本文は gamegene_notebook に ID を渡して取る。件数と要約の合計文字数の両方で打ち切り、予算で切れたときは truncatedByBudget が true になり、nextOffset が実際に返した件数だけ進む。**下書き (公開していないノート) は1件も含まれない。**

gamegene_notebooks

接続の確認だけを行う。データは返さない。

gamegene_ping