カスタムコマンド / カスタム返信 リファレンス

1. 概要

カスタムコマンド（Custom Commands）とカスタム返信（Custom Reply）は、サーバー管理者がダッシュボードから自由に定義できる動的な応答機能です。

両機能ともコードノード（QuickJS サンドボックス）での JavaScript 実行に対応し、
ボタン・セレクトメニューなどのインタラクティブコンポーネントを返せます。

---

2. コードノード（Sandbox）実行環境

コードノードは QuickJS（WASM）上でユーザー定義の JavaScript を実行する隔離環境です。

2.1 セキュリティ制約

コードは同期的に実行されます。fetch、require、process、setTimeoutなどは利用できず、Promiseやawaitを前提とした非同期処理も行えません。

2.2 ctx オブジェクト（SandboxContext）

コードに注入されるグローバル変数 ctx の構造:

ctx = {
  guild: {
    id: string;           // サーバーID
    name: string;         // サーバー名
    memberCount: number;  // メンバー数（Bot 含む）
    ownerId: string;      // サーバー所有者のID
    ownerName: string;    // サーバー所有者のユーザー名
    humans: number;       // 人間メンバー数
    bots: number;         // Bot メンバー数
    roles: Array<{        // ロール一覧（最大100、ポジション降順）
      id: string;
      name: string;
      color: string;      // 16進カラーコード (#XXXXXX)
      memberCount: number;
      position: number;
    }>;
    channels: Array<{     // チャンネル一覧（最大100）
      id: string;
      name: string;
      type: string;       // Discord チャンネルタイプ
    }>;
    createdAt: string;    // ISO 8601 形式
  };
  user: {
    id: string;
    username: string;     // Discord ユーザー名
    displayName: string;  // サーバーニックネーム（なければユーザー名）
    mention: string;      // メンション文字列 (<@userID>)
    isAdmin: boolean;     // Administrator 権限を持つか
    isOwner: boolean;     // サーバー所有者か
    roles: Array<{ id: string; name: string }>;
    joinedAt: string | null;  // 参加日時（ISO 8601）
  };
  channel: {
    id: string;
    name: string;
    mention: string;      // メンション文字列 (<#channelID>)
  };
  args: Record<string, string | number | boolean | null>;
  // カスタムコマンドの初回実行時のみ。user/channel/role 型引数のDiscord ID
  resolved?: Record<string, string | null>;
  // インタラクション（ボタン・セレクト）応答時のみ設定
  interaction?: {
    type: "button" | "select";
    customId: string;         // コードで指定した元の customId
    values?: string[];        // セレクトメニューの選択値
    user: { id: string; username: string; displayName: string };
    messageId: string;
    channelId: string;
  };
};

2.3 戻り値（SandboxResult）

コードノードは関数の戻り値として以下の型を返せます。

2.3.1 テキスト応答

// 単純な文字列
return "こんにちは！";
// => { type: "text", content: "こんにちは！" }

// 明示的なオブジェクト
return {
  type: "text",
  content: "こんにちは！",
  ephemeral: true,    // カスタムコマンドの初回実行では自分だけに表示
};

ephemeral: true はカスタムコマンドの初回実行でだけ利用できます。カスタム返信は通常メッセージへの返信のため、初回応答をエフェメラルにはできません。ボタン・セレクトメニュー操作では、両機能とも responseMode: "ephemeral" を使ってクリックした人だけに返信できます。

2.3.2 埋め込み（Embed）応答

return {
  type: "embed",
  ephemeral: false,
  embed: {
    title: "タイトル",
    description: "説明文",
    color: "#ff0000",
    fields: [
      { name: "フィールド名", value: "フィールド値", inline: true }
    ],
    authorName: "作成者名",
    authorIconUrl: "https://example.com/icon.png",
    footerText: "フッター",
    footerIconUrl: "https://example.com/footer.png",
    imageUrl: "https://example.com/image.png",
    thumbnailUrl: "https://example.com/thumb.png",
  }
};

2.3.3 テキスト + 埋め込み（Both）

return {
  type: "both",
  content: "テキスト本文",
  embed: {
    title: "埋め込みタイトル",
    description: "埋め込み説明",
  }
};

2.3.4 defer（インタラクション応答専用）

// メッセージを変更せず、応答があったことだけ確認する
return { type: "defer" };

※ カスタムコマンドの初回実行では defer は無視されます。
※ カスタム返信では defer は利用できません。
⚠ 初回コマンド実行で defer を返すと、Discord への応答が何も送られず、ユーザーに「このインタラクションに失敗しました」と表示されます。

2.3.5 update（インタラクション応答専用）

// インタラクション応答で元のメッセージを更新する
return { type: "update", content: "更新後のテキスト" };
return { type: "update", embed: { title: "更新後の埋め込み" } };

※ ボタン・セレクトメニューのインタラクション応答でのみ有効です。

2.3.6 コンポーネントインタラクション応答モード（responseMode）

ボタン・セレクトメニューが操作されたときの応答方法を responseMode で指定できます。
指定しない場合は元のメッセージを編集します（後方互換）。

// 元のメッセージを編集（デフォルト）
return {
  type: "text",
  content: "更新しました",
  // responseMode 未指定 → update
};

// 新しい返信を送る
return {
  type: "both",
  content: "詳細情報",
  embed: { title: "追加情報", description: "..." },
  responseMode: "reply",
};

// 自分だけに見える返信
return {
  type: "text",
  content: "あなただけのメッセージ",
  responseMode: "ephemeral",
};

※ responseMode はコンポーネント（ボタン・セレクトメニュー）のインタラクション応答時のみ有効です。初回のコマンド実行・静的返信では無視されます。

2.4 別チャンネルへの送信・ロール操作（カスタムコマンドのみ）

カスタムコマンドでは、通常の応答に actions を追加できます。操作は QuickJS から直接行われず、Bot側で同一サーバー内か、必要な権限があるか、Botより下位の管理可能なロールかを再検証してから実行されます。

return {
  type: "text",
  content: "処理を受け付けました。",
  actions: [
    // 実行チャンネル以外にも送信できます
    { type: "sendMessage", channelId: "123456789012345678", content: "お知らせです" },

    // user/channel/role 型の引数IDは ctx.resolved.<引数名> で取得できます
    { type: "addRole", roleId: ctx.resolved.role, userIds: [ctx.resolved.target] },
    { type: "removeRole", roleId: "234567890123456789", userIds: [ctx.user.id] },
  ],
};

• 操作は実行元と同じサーバー内だけで有効です。
• sendMessageではユーザー・ロール・@everyone・@hereへの通知を抑止します。メンション形式の文字列が名前として表示される場合はあります。
• 通常のコードノード応答にはこの通知抑止は適用されません。通知を発生させたくない文字列はコード側で生成しないでください。
• @everyone、連携サービス管理ロール、Botの最上位ロール以上は操作できません。
• ロール操作はBotの権限で実行されます。実行者本人の「ロールの管理」権限は確認しないため、必ずcommand.allowRole(...)などでコマンドの実行者を制限してください。
• 1実行につき操作は最大5件、うちメッセージ送信は最大3件、ロール操作対象は合計25人です。形式不正や上限超過の要求は破棄されます。
• 失敗した操作は、実行者だけに見えるメッセージで通知されます。

2.5 文字数制限

各フィールドには Discord API 準拠の文字数制限が自動適用されます:

---

3. インタラクティブコンポーネント

コードノードは Discord のボタン・セレクトメニューを動的に生成できます。

3.1 ボタン（SandboxButton）

type SandboxButton = {
  type: "button";
  customId: string;          // 識別子（最大100文字。現行実装ではURLボタンでも必須）
  label: string;             // 表示ラベル（最大80文字）
  style?: "primary"          // 青（デフォルト）
        | "secondary"        // グレー
        | "success"          // 緑
        | "danger";          // 赤
  emoji?: string;            // 絵文字（カスタム絵文字IDも可、最大32文字）
  disabled?: boolean;        // 無効化
  url?: string;              // URLボタン（Linkスタイル）
};

3.2 セレクトメニュー（SandboxSelect）

type SandboxSelect = {
  type: "select" | "stringSelect";
  customId: string;              // 識別子（最大100文字）
  placeholder?: string;          // プレースホルダー（最大150文字）
  options: Array<{
    label: string;               // 選択肢ラベル（最大100文字）
    value: string;               // 選択肢値（最大100文字）
    description?: string;        // 説明（最大100文字）
    emoji?: string;              // 絵文字（最大32文字）
    default?: boolean;           // デフォルト選択
  }>;
  minValues?: number;            // 最小選択数
  maxValues?: number;            // 最大選択数
  disabled?: boolean;            // 無効化
};

単一選択 / 複数選択

デフォルトは 単一選択（minValues: 1, maxValues: 1）です。複数選択を有効にするには maxValues を 2 以上に設定します。

// 単一選択（デフォルト）— 選択肢から1つだけ選ぶドロップダウン
{
  type: "select",
  customId: "color",
  placeholder: "色を1つ選択してください",
  options: [
    { label: "赤", value: "red" },
    { label: "青", value: "blue" },
    { label: "緑", value: "green" },
  ],
  // minValues/maxValues 未指定 → 単一選択
}

// 複数選択 — 選択肢から複数選べる（チェックボックス形式）
{
  type: "select",
  customId: "colors",
  placeholder: "色を複数選択可（最大3つ）",
  minValues: 1,
  maxValues: 3,
  options: [
    { label: "赤", value: "red" },
    { label: "青", value: "blue" },
    { label: "緑", value: "green" },
    { label: "黄", value: "yellow" },
  ],
}

選択された値は ctx.interaction.values で配列として取得できます。

if (ctx.interaction?.type === "select") {
  const selected = ctx.interaction.values; // 例: ["red"]
  const firstValue = ctx.interaction.values[0];
  return {
    type: "text",
    content: `選択されました: ${firstValue}`,
    responseMode: "reply",
  };
}

3.3 コンポーネントの使用例

return {
  type: "text",
  content: "操作を選んでください:",
  components: [
    // 1 行目（最大5個のコンポーネント / 最大5行）
    [
      { type: "button", customId: "yes", label: "はい", style: "success" },
      { type: "button", customId: "no", label: "いいえ", style: "danger" },
      { type: "button", customId: "info", label: "詳細", style: "secondary" },
    ],
    // 2 行目
    [
      {
        type: "select",
        customId: "menu",
        placeholder: "選択してください",
        options: [
          { label: "オプション1", value: "opt1", description: "説明1" },
          { label: "オプション2", value: "opt2", description: "説明2" },
        ],
      },
    ],
  ],
};

3.4 インタラクション応答時の動作

ボタン・セレクトメニューがクリックされると、再度同じコードノードが実行されます。
このとき ctx.interaction が設定されます。

• ctx.interaction.type — "button" または "select"
• ctx.interaction.customId — コードで指定した元の customId
• ctx.interaction.values — セレクトメニューの場合の選択値の配列
• ctx.args — カスタムコマンドでは空オブジェクト（{}）、カスタム返信では { trigger: "（インタラクション）" }

// ボタンインタラクションの処理例
if (ctx.interaction) {
  const id = ctx.interaction.customId;

  if (id === "yes") {
    return { type: "update", content: "「はい」が押されました！" };
  }
  if (id === "no") {
    return { type: "update", content: "「いいえ」が押されました。" };
  }
  if (ctx.interaction.type === "select") {
    const selected = ctx.interaction.values?.[0];
    return { type: "update", content: `選択されました: ${selected}` };
  }

  // responseMode を使った応答方法の変更
  if (id === "details") {
    return {
      type: "both",
      content: "詳細情報",
      embed: { title: "追加情報", description: "ここに詳細が入ります" },
      responseMode: "reply",  // 新しい返信として送信
    };
  }
  if (id === "secret") {
    return {
      type: "text",
      content: "あなただけに表示されるメッセージです",
      responseMode: "ephemeral",  // 自分だけ見える返信
    };
  }
}

3.5 コンポーネント制限

---

4. カスタムコマンド（Custom Commands）

4.1 設定項目（CustomCommand）

type CustomCommand = {
  id?: string;                   // 自動生成される一意ID
  name: string;                  // コマンド名（c_ プレフィックス自動付与）
  description: string;           // 説明（スラッシュコマンドの説明文）
  options?: CommandOption[];     // 引数定義
  executionMode?: "static"       // 静的応答
                  | "code";      // コードノード
  code?: string;                 // コードノードのJSコード
  type?: "text"                  // テキスト返信
        | "embed"                // 埋め込み返信
        | "both";                // テキスト+埋め込み
  content?: string;              // 静的テキスト内容
  ephemeral?: boolean;           // エフェメラル（自分だけ表示）
  enabled?: boolean;             // 有効/無効
  allowedRoleIds?: string[];     // 実行許可ロール。コードノードではコードから派生
  // 埋め込みフィールド（静的応答）
  embedTitle?: string;
  embedDescription?: string;
  embedColor?: string;           // 16進カラーコード（例: "#ff0000"）
  embedAuthorName?: string;
  embedAuthorIconUrl?: string;
  embedFooterText?: string;
  embedFooterIconUrl?: string;
  embedImageUrl?: string;
  embedThumbnailUrl?: string;
  embedFields?: Array<{
    name: string;
    value: string;
    inline?: boolean;
  }>;
};

4.2 コマンド名ルール

• 自動的に c_ プレフィックスが付与されます（例: greet → /c_greet）
• 小文字に正規化され、スペースは - に変換されます。スペース以外の使用不可文字は除去されます
• 使用可能文字: a-z, 0-9, _, -
• 最大 32 文字

4.3 引数オプション（CommandOption）

type CommandOptionType = "string" | "integer" | "boolean" | "user" | "channel" | "role";

type CommandOption = {
  name: string;           // 引数名
  type: CommandOptionType; // 型
  description: string;    // 説明
  required?: boolean;     // 必須
};

コードノードでは ctx.args.<name> でアクセスできます:

// /c_greet user:@someone
// ctx.args.user → ユーザー名（文字列）
// /c_add x:123 y:456
// ctx.args.x → 123（数値）

4.3.1 コード内での引数宣言（command.option）

カスタムコマンド（コードノード）では、ダッシュボードの「引数」エディタを使わずに、コード内で command.option(...) を呼び出すだけで引数を定義できます。

// コード冒頭などで宣言（実行順序の制約はなし）
command.option("target", "user", "対象ユーザー", false);
command.option("message", "string", "メッセージ内容", true);

const target = ctx.args.target;   // ユーザー名（文字列）／未指定時は null
const message = ctx.args.message; // メッセージ内容（文字列）
return { type: "text", content: `${target} へ: ${message}` };

シグネチャ:

command.option(name: string, type: CommandOptionType, description: string, required?: boolean): void

仕組みと注意点:

• 引数は保存時にコードから静的に抽出され、options として DB に反映されます。抽出時にコードは実行されません。
• コードノードでは引数のGUI一覧を表示せず、コードを唯一の編集元として扱います。保存するとDiscordのスラッシュコマンドへ引数プロンプトが反映されます。
• コードエディタ上で宣言を追加・変更・削除すると、内部のoptionsもコードから再生成されます。
• 実行時には command は何もしない（no-op）グローバルとして注入されるため、コード内に書いても副作用はありません。
• 最大 25 個まで宣言できます（Discord の上限）。
• 静的応答（executionMode = static）の場合は、この機能は使えず、引数はダッシュボードのエディタで設定します。

4.3.2 コード内での実行許可ロール宣言（command.allowRole）

コードノードでは、コマンドを実行できるロールもコード内で宣言できます。判定はコードの実行前に行われます。

command.allowRole("123456789012345678");
command.allowRole("234567890123456789");

return { type: "text", content: "許可されたユーザーです。" };

複数宣言した場合は、いずれか1つのロールを持つユーザーが実行できます（OR条件）。宣言がない場合は全員が実行できます。サーバーオーナーとAdministrator権限保持者は宣言にかかわらず実行できます。

command.allowRole(roleId: string): void

• ロールはDiscordのロールIDで指定し、最大 10件まで宣言できます。
• 保存時にコードを実行せず静的に抽出し、存在しないロールIDは保存APIで拒否されます。
• ボタンやセレクトメニューによる後続操作でも同じ権限を再確認します。
• 実行時のcommand.allowRole(...)自体は何もしないno-opです。
• コードエディタ上で宣言を削除すると内部のallowedRoleIdsも更新され、宣言が0件なら全員許可へ戻ります。

複数のロールをすべて要求する場合（AND条件）は、入口となる許可ロールに加えてctx.user.rolesを確認します。

command.allowRole("123456789012345678");
command.allowRole("234567890123456789");

const requiredRoleIds = ["123456789012345678", "234567890123456789"];
const userRoleIds = new Set(ctx.user.roles.map((role) => role.id));
const hasAllRoles = requiredRoleIds.every((roleId) => userRoleIds.has(roleId));

if (!hasAllRoles && !ctx.user.isAdmin && !ctx.user.isOwner) {
  return { type: "text", content: "必要なロールが不足しています。", ephemeral: true };
}

return { type: "text", content: "すべての必要ロールを確認しました。", ephemeral: true };

4.4 静的応答の変数展開

静的テキスト・埋め込みでは以下のプレースホルダーが自動展開されます:

---

5. カスタム返信（Custom Reply）

5.1 設定項目（CustomReply）

type CustomReply = {
  id?: string;                   // 自動生成される一意ID
  trigger: string;               // トリガーワード/パターン
  matchType?: "exact"            // 完全一致
               | "contains"      // 部分一致（デフォルト）
               | "startsWith"    // 前方一致
               | "endsWith"      // 後方一致
               | "regex";        // 正規表現
  caseSensitive?: boolean;       // 大文字小文字区別（デフォルト: false）
  allowedChannelIds?: string[];  // 許可チャンネルID一覧（空=全チャンネル）
  executionMode?: "static"       // 静的応答
                  | "code";      // コードノード
  code?: string;                 // コードノードのJSコード
  type?: "text" | "embed" | "both";
  content?: string;
  enabled?: boolean;
  // 埋め込みフィールド（静的応答）
  embedTitle?: string;
  embedDescription?: string;
  embedColor?: string;
  embedAuthorName?: string;
  embedAuthorIconUrl?: string;
  embedFooterText?: string;
  embedFooterIconUrl?: string;
  embedImageUrl?: string;
  embedThumbnailUrl?: string;
  embedFields?: Array<{
    name: string;
    value: string;
    inline?: boolean;
  }>;
};

5.2 トリガーマッチング

カスタム返信はメッセージが送信されるたびに、定義順にトリガーマッチングを行います。
最初にマッチした返信のみが送信されます。

注意点

• Bot のメッセージには反応しません。
• 正規表現モードでは ReDoS 対策が適用されています。
• コードノードでは ctx.args.trigger に元のメッセージ全文が設定されます。
• チャンネル許可リスト（allowedChannelIds）が設定されている場合、指定チャンネルでのみマッチします。
• ダッシュボードで設定を変更すると、即座に反映されます。

5.3 静的応答

カスタム返信の静的応答はカスタムコマンドと異なり、{arg:<name>} 引数プレースホルダーは利用できません。
ただし、ユーザー・サーバー・チャンネル情報のプレースホルダー（{user.name}、{guild.name}、{channel.name} 等）は展開可能です。

---

6. インタラクティブコンポーネントのルーティング

コードノードからボタン・セレクトメニューを含む応答を返すと、コンポーネントが操作された際に同じコードノードが再実行されます。この仕組みにより、ボタンクリックやメニュー選択に応じた動的な応答が実現できます。

処理の流れ

1. コードノード実行 → components を含む結果を返す
2. コンポーネントが Discord に送信される
3. ユーザーがボタン/セレクトをクリック
4. 同じコードノードが ctx.interaction 付きで再実行される
5. 応答（メッセージの更新など）が返される

各コンポーネントの識別子（customId）は内部で一意に管理され、正しいコードノードにルーティングされます。customId の重複を気にせず、各コードノード内で一意であれば問題ありません。

ルーティング情報の有効期間は24時間です。期限切れ後は、ユーザーへ再度コマンドを実行するよう案内されます。設定が無効化・削除・変更された場合も、操作時に現在の設定を再確認します。

---

7. URL コンテンツフィルター

URLドメイン許可リストに基づくフィルタリングが適用されます。現行実装ではコードノードの本文・埋め込み・リンクボタン、および静的応答の本文が対象です。静的応答の埋め込みURLフィールドは対象外です。

7.1 フィルター対象

• テキスト content 内の URL
• コードノード埋め込みの title, description, fields[].name/value, authorName, footerText 内の URL
• コードノード埋め込みの URL 系フィールド（authorIconUrl, footerIconUrl, imageUrl, thumbnailUrl）のドメイン
• コードノードのリンクボタンに指定したURL

7.2 動作

• 許可リストが空の場合 → フィルターは何も行いません（全 URL 許可）
• 許可リストにドメインが設定されている場合 → 許可されていないドメインの URL はテキストから除去されます
• URL 系フィールドのドメインが許可されていない場合 → フィールドが undefined になります

---

8. 制限値・制約一覧

8.1 共通

8.2 カスタムコマンド

8.3 カスタム返信

---

9. KVストア

コードノードから利用できるキーバリューストアです。データは永続化され、同じサーバー内の異なるコードノード実行間で共有されます。

9.1 API

コードノード内でグローバル変数 kv を通じてアクセスできます。

9.2 使用例

// カウンター
const count = (kv.get("count") ?? 0) + 1;
kv.set("count", count);
return { type: "text", content: `${count}回目の実行です` };

// 設定の保存
let config = kv.get("config") ?? { color: "#5865F2", prefix: "!" };
if (ctx.args.color) config.color = ctx.args.color;
kv.set("config", config);
return {
  type: "embed",
  embed: {
    title: "現在の設定",
    fields: [
      { name: "色", value: config.color, inline: true },
      { name: "接頭辞", value: config.prefix, inline: true },
    ],
    color: config.color,
  },
};

// アクセス履歴
const log = kv.get("access_log") ?? [];
log.push({ user: ctx.user.username, at: new Date().toISOString() });
kv.set("access_log", log.slice(-50)); // 最新50件
return {
  type: "text",
  content: `${ctx.user.mention} さん、履歴を記録しました（全${log.length}件）`,
};

// キーの削除
kv.delete("temp_data");
return { type: "text", content: "一時データを削除しました" };

// 全キーの一覧
const keys = kv.keys();
return {
  type: "text",
  content: `保存されているキー: ${keys.join(", ") || "（なし）"}`,
};

9.3 制限値

9.4 注意事項

• 値は自動で JSON シリアライズされます: 42 は数値として保存・取得され、"hello" は文字列として返ります。
• データの競合: 同じキーに同時に書き込みがあった場合、最後に書き込んだ値が維持されます（last-write-wins）。

9.5 外部API（HTTP）からの利用

KVストアは、Bot のコードノードだけでなく HTTP API からも読み書きできます。
外部のアプリケーション（Webサービス・自作ツールなど）からこのサーバーの KV データを直接操作したい場合に利用します。

APIキーの取得

1. ダッシュボードの サーバー設定 → KVストア → 外部APIキー を開く
2. 「キーを作成」 をクリック（キー名を任意で設定）
3. 表示されたフルキーをコピーする（この場面で一度だけ表示され、閉じた後は確認できません）

⚠ APIキーの発行・失効はサーバーオーナーのみ行えます。

• キーの形式: kkv_ から始まるランダム文字列（例: kkv_AbC123...）
• キーは削除ではなく 失効（revoke）で無効化します
• キーを紛失した場合は失効して新しいキーを作成してください

エンドポイント

• :guildId はサーバーID、:key はキー名です
• 認証は Authorization: Bearer <APIキー> ヘッダー（または X-API-Key ヘッダー）で行います
• キー名に使える文字: a-zA-Z0-9._-（最大128文字）。値は 256KB 以内
• 1キーあたり 1分間に120リクエスト まで
• 作成できるキーの総数は 1ギルドあたり最大500 まで

使用例（curl）

# 全キー取得
curl -H "Authorization: Bearer kkv_AbC123..." \
  https://frex.kokonatsu.net/api/public/kv/123456789012345678

# 単一キー取得
curl -H "Authorization: Bearer kkv_AbC123..." \
  https://frex.kokonatsu.net/api/public/kv/123456789012345678/count

# キーの作成・更新（value は JSON 文字列）
curl -X PUT \
  -H "Authorization: Bearer kkv_AbC123..." \
  -H "Content-Type: application/json" \
  -d '{"value":"42"}' \
  https://frex.kokonatsu.net/api/public/kv/123456789012345678/count

# キー削除
curl -X DELETE \
  -H "Authorization: Bearer kkv_AbC123..." \
  https://frex.kokonatsu.net/api/public/kv/123456789012345678/count

API のベース URL は https://frex.kokonatsu.net（/api/public/kv/...）です。

レスポンス形式

// GET 全キー取得
{
  "success": true,
  "data": [
    { "key": "count", "value": "42", "updatedAt": "2026-08-05T12:00:00.000Z" }
  ]
}

// GET 単一キー取得
{
  "success": true,
  "data": { "key": "count", "value": "42", "updatedAt": "2026-08-05T12:00:00.000Z" }
}

// PUT / DELETE 成功時
{ "success": true }

• value は JSON化された文字列 として返ります（42 は "42"、文字列は "\"hello\""）
• 認証失敗: 401 Unauthorized / 他サーバーへのアクセス: 403 Forbidden
• キー名が不正: 400 / 存在しないキーの取得: 404|