コンテンツにスキップ

CMS

CMS は、Web サイトのコンテンツ管理をその持ち主に渡すための機能です。クライアントはここで編集し、ページを描画するのは制作したサイトのままです。

ヘッドレス CMS なので、テーマもテンプレートもフロントエンドも持ちません。コンテンツを公開すると、Minion Workspace が公開ストレージにただの JSON ファイルを書き出します。制作したサイトはそのファイルを (多くの場合ビルド時に) 読み、好きなように描画します。

この切り分けが設計のすべてです。

  • 閲覧者が当社を経由しません。 サイトが読むのは静的ファイルなので、アクセスが増えても料金は変わらず、当社の障害がクライアントのサイトの障害になりません。
  • リクエスト数で課金しません。 リクエストが当社に来ないので、そもそも計測する対象がありません。
  • いつでも卒業できます。 公開されているものは既にただの JSON ファイルです。書き出し (エクスポート) を使えば、そのファイル群とスキーマと画像が 1 つの ZIP で手に入ります。

1. サイトを作る。 案件ごとに 1 つ作ります。あとで複製・譲渡・削除する単位になります。

2. コンテンツ型を作る。 コンテンツ型は「扱うコンテンツの種類」です。ブログ記事、お知らせ、スタッフ紹介など。形を選びます。

種類用途公開される形
リスト同じ形のエントリを複数持つもの (記事・お知らせ・商品)エントリの配列
オブジェクト1 件しかないもの (サイト設定・トップページ)単体のオブジェクト

あわせて API ID (posts、news など) を決めます。これが公開される JSON のファイル名になるため、あとから変更できません。

3. フィールドを定義する。 各フィールドは ラベル と API ID を持ちます。ラベルは編集者に見える名前で、いつでも変えられます。API ID は公開 JSON のキーになるため、スキーマを公開したあとは固定されます。スキーマビルダーには、定義したフィールドがどんな JSON になるかのプレビューが出ます。

4. エントリを書いて公開する。 下書きの保存は公開面を一切変えません。公開すると、その版が固定され、ファイルが書き出されます。

5. サイトの公開を開始する。 公開は公開ストレージへの書き出しなので、先にワークスペースへ決済手段を登録していただきます。課金はしません。 誰でも無料で使える匿名の公開ストレージは、構造的にフィッシングやマルウェアの置き場になるための措置です。

6. サイトから読み込む。 「配信」タブに、そのサイトのコンテンツ型ごとの URL がコピーボタン付きで並びます。fetch / Next.js / Astro のコード例もそのまま貼れます。

const res = await fetch('https://…/{siteId}/api/posts.json')
const { contents } = await res.json()

公開すると、コンテンツ型ごとに 1 ファイル、エントリごとに 1 ファイル、そしてマニフェストが書き出されます。

ファイル内容
/api/index.jsonサイトのコンテンツ型の一覧 (フロントがどの API があるかを知るため)
/api/{apiId}.jsonリスト型のエントリ一覧、またはオブジェクト型の単体
/api/{apiId}/{entryId}.json個別エントリ (id で引く)
/api/{apiId}/{slug}.json同じエントリ (slug で引く)

リスト型のファイルはページング形式のレスポンスです。読み取り API と同じ形なので、同じコードがどちらにも使えます。

{
"contents": [ /* エントリ */ ],
"totalCount": 12,
"offset": 0,
"limit": 12
}

エントリは共通のシステムキーを持ち、そのあとに定義したフィールドが API ID をキーとして並びます。

{
"id": "…",
"slug": "hello-world",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"publishedAt": "2026-01-01T00:00:00.000Z",
"sortOrder": 0,
"title": "こんにちは",
"body": "# こんにちは\n…"
}

テンプレートを書く前に知っておくと良いことが 2 つあります。

  • 並び順は適用済みです。 エントリ一覧の画面と同じ順序 (手動の並び替え → 公開日の新しい順) で出ます。
  • 参照は 1 段だけ展開されます。 参照先のエントリはオブジェクトとして入ります。未公開だったり 1 段より深い場合は null ではなく { "id": "…" } になるので、ref.id を読むテンプレートが落ちることはありません。

このファイルを読めるのは誰か

Section titled “このファイルを読めるのは誰か”

URL を知っている人は誰でも読めます。公開済みのコンテンツに認証はありませんし、付けられません。訪問者のリクエストが私たちのところに来ないのはそのためで、アクセスが増えても料金が変わらず、私たちの側の障害がクライアントのサイトを止めないのもここから来ています。

計画に織り込んでおくべき点が 2 つあります。

  • サイト ID は秘密ではありません。 メディアの URL に含まれ、制作したサイトの HTML にそのまま入ります。ページを見た人は /api/index.json を読めるので、そこからすべてのコンテンツ型と公開済みエントリを列挙できます (フロントがリンクしていないものも含みます)。
  • 「公開したがまだリンクしていない」は非公開ではありません。 ある日付まで読まれては困るものは、先に公開してあとからリンクするのではなく、未公開のまま予約公開を設定してください。

下書きは影響を受けません。未公開のエントリはこれらのファイルに一切書き出されません。API キーが守るのは読み取り API (下書きと書き込み) であって、公開済みのコンテンツではありません。 公開したものへのアクセス制御として扱わないでください。

型JSON補足
テキスト"…"1,000 文字まで
テキストエリア"…"20,000 文字まで
リッチテキスト"…"実体は Markdown。200,000 文字まで
数値0
真偽値true
日付"2026-01-01"
選択肢"news"内部の値ではなくラベルが出ます
画像 / ファイル{ … }メディアオブジェクト (下記)
コンテンツ参照{ "id": …, "slug": … }他のエントリ。1 段展開
繰り返し[ { … } ]オブジェクトの配列。ネストは 1 段、200 行まで
埋め込み URL"https://…"YouTube / Vimeo の URL。動画ホスティングは持ちません

「複数」を有効にしたフィールドは、同じ形の配列になります。

メディアのフィールドはファイル情報に展開されます。

{
"id": "…",
"url": "https://…",
"object_key": "…",
"filename": "cover.jpg",
"mime_type": "image/jpeg",
"byte_size": 148213,
"width": 1200,
"height": 630,
"alt": "…",
"variants": [{ "width": 800, "format": "webp", "url": "https://…" }]
}

variants はアップロード時に生成した縮小版です。そのまま使っても、srcset に並べても構いません。

リッチテキストを持つコンテンツ型では、エントリの編集画面が書くための並びになります。最初のテキストが見出しとして大きく表示され、その下に本文が続きます。それ以外のフィールドと公開設定 (スラッグ・予約公開) は右の欄にまとまります。

リッチテキストを持たない型 (サイト設定など) は、フィールドがスキーマの順に 1 列で並びます。

何を大きく見せるかは型ごとに変えられます。実績紹介やギャラリーのように画像が主役の型では、コンテンツ型の設定 → 執筆画面の主役で「自分で選ぶ」にし、画像のフィールドを選んでください。選んだ順に左の欄へ並び、残りは右の欄に並びます。この設定は編集画面の並びを変えるだけで、公開される JSON には影響しません (再ビルドも走りません)。

リッチテキストは、見出しや太字が見えるまま書けます (ビジュアル編集)。書式は入力欄の上のボタンから選びます。保存される形は Markdown のままなので、フロント側の読み方は変わりません。

入力欄の右上にある ビジュアル / Markdown の切り替えで、Markdown をそのまま編集する表示と行き来できます。切り替えはどちらの表示でも同じ場所にあります。

すでにある本文に、ビジュアル編集では保てない書き方 — 表、HTML、タスクリスト、脚注、段落の中の改行 — が含まれていると、その本文は Markdown のまま開きます。開いて保存しただけで形が変わるのを防ぐためです。ビジュアル編集に切り替えることもできますが、その書き方は失われるか、形が変わります。

繰り返しフィールドの中のリッチテキストは、Markdown のまま書きます。

ツールバーの画像ボタン (Markdown のまま編集しているときは同じ場所の**「画像を挿入」**) を押せば、メディアから選ぶ (またはその場でアップロードする) だけでカーソル位置に入ります。URL を手で写す必要はありません。保存される形は ![代替テキスト](URL) です。

代替テキストを登録してある画像はそれが入ります。空の画像は、ビジュアル編集では代替テキストの欄にカーソルが移り、Markdown のままの編集では ![](URL) の角括弧の中にカーソルが戻るので、そのまま説明を書いてください。手順の解説に使う図では代替テキストが本文の一部なので、ファイル名で埋めることはしていません。

画像フィールドと違い、本文に入るのは URL の文字列です。書き出した Markdown が他の場所でそのまま通るのはこのためです。なお本文で使っている画像も、メディアを削除しようとすると使用中として警告が出ます。

フィールドは不変の内部 ID で、選択肢は不変の値で保存されています。つまり:

  • ラベルの変更はいつでも安全です。 公開中のサイトは何も変わりません。
  • API ID はスキーマを公開したあと変更できません。 フロントが読んでいるキーそのものだからです。
  • 選択肢のラベルを変えると公開 JSON が変わります。 公開されるのはラベルのほうなので、コンテンツの編集として扱ってください。
  • スキーマを変えても既存のエントリは壊れません。 各エントリは自分が書かれた版のスキーマで解釈されます。削除したフィールドは出力に出なくなるだけです。

下書きは静的ファイルには一切書き出されません。「編集した瞬間に公開ページが壊れる」ことがないのはこのためです。未公開の内容を表示したいときは、読み取り API を使います。

Terminal window
curl -H "X-CMS-API-KEY: YOUR_READ_KEY" \
"https://minionworkspace.com/api/public/cms/{siteId}/posts?draftKey=YOUR_DRAFT_KEY"

読み取りキーは「配信 → API キー」で発行します。下書きキーも同じタブにあり、漏れた場合は再発行できます。このキーがあるのは、このエンドポイントが下書きを返せるためです。公開済みのコンテンツを守っているものではありません (公開済みのファイルは URL を知っていれば誰でも読めます) (X-MICROCMS-API-KEY も受け付けるので、microCMS 向けに書いたフロントはこの部分を変えずに済みます)。

「設定」の プレビュー URL に制作したサイトのプレビュー用ページを設定しておくと、編集画面の「プレビュー」から生の JSON ではなくそのページが開きます。

1 つのサイトに 1 本とは限りません。ブログと実績が別のページとして作られている場合は、コンテンツ型の「設定 → プレビュー先」にその型専用の URL を設定すると、サイト全体の設定をその型だけ上書きできます。サイト設定やフッターのように単独で開くページがない内容は「プレビューしない」にしておくと、サイトの URL をたどって 404 になる代わりに、読み取り API の応答がそのまま表示されます。

公開前の内容を社内外に確認してもらうときは、編集画面の「共有リンク」を使います。有効期限 (1 日 / 7 日 / 30 日) を選ぶと URL が出るので、それを渡してください。受け取った人は Minion Workspace のアカウントがなくても、そのページを開けます。

このリンクで開けるのは、その原稿の下書きだけです。 同じ原稿の他の言語版は開けますが、 サイトの他の未公開エントリは見えません。設定画面に出ている下書きキーをそのまま配ると 全部の下書きが読めてしまうので、人に渡すときは必ず共有リンクのほうを使ってください。

配ったリンクを個別に止めることはできません。まとめて無効にしたいときは、「配信 → API キー」 で下書きキーを再発行します (発行済みの共有リンクが一斉に切れます)。

読み取り API のクエリは microCMS 互換のサブセットです。

パラメータ例
limit / offsetlimit=10&offset=20既定 10、最大 100
ordersorders=-publishedAt,title- で降順
fieldsfields=id,title応答を絞る
filtersfilters=category[equals]news[and]title[contains]告知equals / not_equals / contains / begins_with / exists / not_exists を [and] [or] で連結。左から順に評価
depthdepth=2参照の展開段数。最大 3
qq=キーワードエントリ全体への全文検索

レート制限はサイトごとに読み取り 300 回 / 分、書き込み 60 回 / 分です。

静的に生成するサイトでは、コンテンツを公開しただけでは半分です。サイト側の再ビルドが要ります。Webhook はそのためにあります。

まずホスティング側でビルドフックを作り (Vercel は Settings → Git → Deploy Hooks、Netlify は Site configuration → Build & deploy → Build hooks)、その URL を「配信 → Webhook」に貼ります。以降は公開のたびにビルドが走ります。登録したらすぐ テスト を送ってください。届いていない Webhook に気づくなら、来週ではなく今のほうが安上がりです。

購読するイベントは選べます。空のままにすると全イベントを受け取ります。

entry.published · entry.unpublished · entry.deleted · content_type.updated · site.published

ペイロードは JSON で、x-cms-event ヘッダ付きで送られます。

{
"event": "entry.published",
"site_id": "…",
"content_type": "posts",
"entry_id": "…",
"entry_slug": "hello-world",
"occurred_at": "2026-01-01T00:00:00.000Z"
}

ペイロードに署名する を有効にすると x-cms-signature ヘッダが付きます。作成時に一度だけ表示されるシークレットで、本文そのものを HMAC-SHA256 したものです。ビルドを叩く以上のことをする受け口なら検証してください。

Webhook の失敗で公開が巻き戻ることはありません。ビルドが落ちても、コンテンツは正しく公開されたままです。ビルドを直して再度発火させてください。

エントリには 公開日時 と 公開終了日時 を設定できます。実行は 5 分間隔なので、「その時刻から 5 分以内」と考えてください。予約公開も手動の公開と同じ検証を通ります。必須項目が空のときは、予約を黙って取り下げずに失敗として報告するので、エントリを直せば次の実行で公開されます。

OGP画像を生成する (実験的機能)

Section titled “OGP画像を生成する (実験的機能)”

記事ごとに OGP 画像を作るのは手間のかかる作業です。CMS はエントリの内容から画像を生成できます。対応言語は現在 日本語と英語 です。

  1. サイト画面の 「OGP画像」タブを開く
  2. **「テンプレートを追加」**でテンプレートを作る(雛形が入った状態で始まります)
  3. 同じタブの下にある **「生成した画像の置き先」で、コンテンツ型に画像フィールドが有るか確認する。無ければ「画像フィールドを追加」**を押す
  4. エントリを開くと、その画像フィールドの中に 「画像を生成」ボタンが出るので、押して保存する

3 が要るのは、生成した画像を普通の画像フィールドに入れるためです。OGP 専用のフィールドは用意していません — 配信される JSON の形は、あくまでご自身が定義したスキーマで決まるようにしてあるためです。自分で用意した画像を使う場合も同じフィールドに入れます。

勝手には作りません。 エントリ画面の「画像を生成」を押したときだけ動きます。公開しても自動では生成されません。自分で用意した画像を使いたいときは、この機能を使わずに画像フィールドで直接選んでください。生成した画像も普通のメディアなので、あとから差し替えるのも同じ操作です。

生成した画像はフィールドに置かれるだけで、保存するまで確定しません。気に入らなければ保存せずに離れてください。

デザインはサイトごとに違うので、テンプレートは自分で書きます。サイト画面の 「OGP画像」タブで編集でき、入力の右側に実際の描画結果がその場で出ます。

<div style="width:100%;height:100%;display:flex;flex-direction:column;justify-content:space-between;background-color:#0F172A;padding:72px 80px">
<div style="display:flex;width:120px;height:10px;background-color:#5ABFBC;border-radius:999px"></div>
<div style="display:flex;font-size:64px;font-weight:700;color:#F1F5F9;line-height:1.25">{{fields.title}}</div>
<div style="display:flex;font-size:30px;color:#94A3B8">example.com</div>
</div>

使える変数:

変数入るもの
{{fields.title}}エントリの値 (title はフィールドの API ID)。選択肢は表示ラベル、日付は YYYY-MM-DD
{{slug}} / {{locale}}エントリのスラッグ / 言語
{{media.<ID>}}ロゴなど固定の画像。「画像を挿入」ボタンが正しい形で差し込みます

リッチテキスト・繰り返し・コンテンツ参照・埋め込みURL・ファイルは空になります。カードは 1 枚絵なので、本文を流し込む場所ではありません。

描画エンジンの都合で、使える CSS はブラウザより狭くなっています。

  • flexbox だけです。display: grid は使えません
  • 子要素が 2 つ以上ある要素には display: flex が必要です
  • 画像はこのサイトのメディアだけ置けます。外部URLやデータURIは指定できません
  • WebP と AVIF は描画エンジンが読めないため、埋め込むときに PNG / JPEG へ自動で変換します (メディア側は元のままです)
  • Tailwind 風の tw="..." 属性も使えます

守れていないときはプレビューにエラーがそのまま出るので、直しながら書き進められます。

言語ごとにテンプレートを分ける

Section titled “言語ごとにテンプレートを分ける”

タイトルなどエントリ由来の文字は、すでに言語ごとに書かれているのでそのまま翻訳された状態で入ります。翻訳されないのはテンプレートに直接書いた文字 (「ブログ」などの見出し) だけなので、そこを変えたい場合はテンプレートに言語を割り当ててください。言語を指定しないテンプレートは全言語で使われます。

エントリを直しても画像は自動では作り直されません。作った時点から内容が変わっていると、エントリ画面に「内容が変わっています」と出るので、必要なときだけ生成し直してください。生成は保存済みの内容を使うので、先に保存してから押してください。

テンプレートの編集は編集者の権限が要ります。組み込みが終わって執筆者に権限を絞ると、コンテンツ型や提供言語と同じようにテンプレートも変更できなくなります。生成の実行は執筆者でもできます。

テンプレートは HTML です。自分で書く必要はありません。ミニオンに頼んでください。 ミニオンはテンプレートを書き、実際に描いて仕上がりを確かめ、記事ごとの画像を生成して記事に入れるところまで通しでできます。あなたの仕事は、できあがったカードを見て採否を決めることです。

「ブログのOGPテンプレートを作って。背景は濃紺、タイトルを大きく、右下にサイト名を入れて」

頼む前に、サイトの設定 → アクセス権でそのミニオンに編集者を付けてください(テンプレートの編集に要る権限です)。テンプレートができた後、画像の生成だけを任せるなら執筆者で足ります。

ミニオンが記事に画像を入れても、公開はされません。 公開中の記事の画像を差し替えたときは、いつもどおり公開の操作が別に必要です。

プランで決まるのはサイト数とストレージの 2 つです。プランごとの値は 料金プラン にあります。

  • サイト数は、公開・非公開を問わずワークスペースの全サイトを数えます。上限に達すると、サイトの作成と複製ができなくなります
  • ストレージは CMS 専用ではなく、ワークスペース全体で 1 つの枠です。ドライブのファイルやノートの画像と分け合います。CMS のぶんとして数えるのは、メディアの原本・サイズ違いの派生画像・生成した OGP 画像です
  • 画像 1 枚の上限は 25 MB で、どのプランでも同じです

上限を超えて止まるのは新規アップロードだけです。既に公開しているファイルは配信され続け、公開の操作も通ります。容量を理由にクライアントの稼働中のサイトを落とすことはしません。

ワークスペースのメンバーは全員サイトを見られます。ただし、許可するまで誰も変更できません。

権限できること
管理者すべて (公開の開始停止・API キー・Webhook・アクセス権・サイトの削除)
編集できるコンテンツ型とスキーマの変更、および執筆者ができること全部
執筆できるエントリとメディア (執筆・公開・アップロード)
閲覧のみ読み取り。ワークスペースメンバーの既定

管理者は自動で決まります (ワークスペースの owner・admin と、サイトを作った本人)。残りの 2 つは サイトごとに設定 → アクセス権で付与します。付与を外すと、その人は閲覧のみに戻ります。

コンテンツを書く人には執筆できるを、構造を変えてよい人にだけ編集できるを付与してください。 フィールドを削除すると、そのエントリを次に公開した時点で公開 JSON から消えます。執筆担当者が うっかり踏んでよい操作ではありません。

サイトを繋ぎ終えると、配信タブとスキーマタブは役目を終え、コンテンツを書く人にとっては ノイズになります。設定 → 組み込みモードでこれを畳むと、執筆に必要な画面だけになります。 エントリの編集画面で各フィールドに添えられている API ID も、あわせて出なくなります。 引き渡す前にオフにし、繋ぎ方を変えるときにまたオンにしてください。

変わるのは表示だけで、誰に何が許されるかは変わりません。サイトを守っているのは上の権限のほうです。 執筆できる・閲覧のみの人には、この設定に関係なくこれらのタブは出ません。

ヘッドレス CMS が本当に失敗するのは、機能が足りないときではなく、クライアントが結局 更新しないときです。ミニオンはこの CMS を人と同じ入口から操作できるので、「来月の お知らせを 3 本入れておいて」を人ではなくミニオンに頼めます。

権限の仕組みも人と同じです。設定 → アクセス権にはワークスペースのミニオンも並び、 既定は閲覧のみ。付与するまで何も書けません。

執筆できるを付けたミニオンは、エントリの作成・更新・公開ができます。ただし ミニオンが作ったものは必ず下書きから始まり、公開は「公開して」と明示的に指示された ときにしか起きません。書いたものが確認を挟まずに本番へ出ることはない、ということです。

編集できるを付けると、コンテンツ型とスキーマも作れるようになります。サイトを繋ぐ ときに「この構成に必要なコンテンツ型を作って」から任せられるのはこの権限です。組み込みが 済んだら**執筆できるに戻してください。**構造はそこで凍り、以後は記事の更新だけができる 状態になります。フィールドの削除は次の公開で公開 JSON から項目を消すので、日々の更新を 任せる相手が持ち続けてよい権限ではありません。

画像のアップロードもミニオンに任せられます。 執筆できる以上を付けてあれば、記事に 使う画像を自分で上げて、本文や画像フィールドに入れるところまで通しでできます。「この画面の スクリーンショットを撮って記事に入れて」が 1 回の依頼で終わるのはこのためです。代替テキストも アップロードと同時に付けます。

2 つだけ、ミニオンにはできないことがあります。ミニオンは管理者になれません — API キーの発行・Webhook・サイトの削除・アクセス権の付与は人の操作です。そして画像を削除 できません。公開中のサイトが使っている画像を消す操作なので、人が確認してから行います。

複製は、同じコンテンツ型・同じスキーマ・同じ API ID を持つ新しいサイトを作ります (エントリと画像も含めるか選べます)。複製先は必ず非公開で始まり、エントリは下書きになります。API キーと Webhook は意図的に引き継ぎません。破壊的なスキーマ変更を試すときや、前の案件の構成を次の案件で使い回すときに使ってください。

譲渡はサイトを別のワークスペースへ移します。相手のワークスペーススラッグを入力すると、相手の管理者が受け入れた時点で移ります。サイトの公開面の識別子は何も変わりません。メディアの URL も API のパスも API キーも Webhook も、ワークスペースではなくサイトに紐づいているためです。稼働中のサイトを止めずに渡せますし、クライアントの CI の環境変数を書き換える必要もありません。

計画に織り込んでおくとよい点が 2 つあります。サイトごとのアクセス権は破棄されます (旧ワークスペースのメンバーを指していたため)。既定は閲覧のみなので、受け取り側は管理者が自分たちのメンバーに権限を付与するまで、管理者以外は編集できません。そして譲渡先のプラン上限を超えていても譲渡は成立します — 既存のファイルは配信され続け、止まるのは新規アップロードだけです。

書き出しは、下書きを含む全コンテンツ・中立的な形式のスキーマ定義・メディアを 1 つの ZIP にまとめます。

published/ フォルダには、配信していた JSON がそのままの形で入っています。移行の途中でも、このファイル群を任意の静的ホスティングに置けばサイトは動き続けます。

メディアの同梱は 200 MB で打ち切り、超えた分はマニフェストに URL 参照として載せます。打ち切りは README・マニフェスト・レスポンスヘッダに必ず明記され、黙って減らされることはありません。