結論
Strapi は、Node.js で動くオープンソースのヘッドレスCMSです。管理画面でコンテンツの型(記事・お知らせなど)を作ると、REST API が自動で用意され、プラグインを足せば GraphQL でも取り出せます。自分のサーバーに置く Community プランは無料で、運用まで任せる Strapi Cloud は月35ドルの Starter からです(2026年11月18日時点)。
この記事でわかること
- Strapi 5 の要件・インストールの手順と、作られるファイルの中身
- REST API・GraphQL の呼び出し方と、qs で組んだクエリの実物
- 料金の試算、microCMS との違い、つまずきの表と判断表
この記事で実際に動かしたもの:Strapi 5.63.0 の作成コマンド(create-strapi)を入れて --help を出し、外への送信を止めた状態でプロジェクトのひな形を作って中身を確かめました。Strapi が内部で使う qs 6.17.0 で REST API のクエリ文字列を組み、配列の上限(arrayLimit)の境目を確かめ、公式の応答例を返す 127.0.0.1 の模擬サーバーでクライアントのコードを動かしました。料金は Python で計算しています。本体の依存パッケージは作業用の容量(約300MB)に収まらず、管理画面の起動はしていません。Strapi Cloud には登録もサインインもしていません。
Strapi はコンテンツを入れて API で配る「裏側」だけを受け持ちます。表示する画面(Web サイト・スマホアプリ)は別に作り、API でデータを取りに行きます。
flowchart TD
E[編集する人] -->|管理画面| S[Strapi]
S --> D[(データベース)]
S -->|REST| W[Web サイト]
S -->|GraphQL| A[アプリ]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Strapi とは | Node.js 製のオープンソースのヘッドレスCMS。API を自動で作る | Strapiとは |
| Strapi は無料? | 自分で動かす Community プランは無料(MIT ライセンス) | Strapiの料金 |
| Strapi の最新版 | 5.63.0(2026年11月18日公開)。Node.js は v22・v24・v26 | 最新版と動作要件 |
| Strapi のインストール | npx create-strapi@latest → npm run develop |
インストールの手順 |
| API を叩くと 403 になる | 既定は非公開。Public ロールに find・findOne を付ける | 権限の考え方 |
| REST API の取り方 | GET /api/複数形の名前。1件は documentId で引く |
REST APIの呼び出し |
| GraphQL を使うには | @strapi/plugin-graphql を入れると /graphql ができる |
GraphQLの呼び出し |
| Strapi Cloud の料金 | Starter 月35ドル・Pro 月90ドル・Business 月450ドル | Strapiの料金 |
| microCMS との違い | 自分で動かせる OSS か、提供元が運用する SaaS か | microCMSとの違い |
確認環境:Linux(x86_64)・Node.js 22.23.4・npm 10.9.9 で、npm レジストリから create-strapi 5.63.0 を取得し、create-strapi --help と、--no-install --skip-cloud --no-git-init --no-example --skip-db --ts を付けたプロジェクトの作成を実行しました。実行時は環境変数 STRAPI_TELEMETRY_DISABLED=true を入れ、HTTPS_PROXY を使えない宛先(127.0.0.1:9)に向けたうえ、Node.js の接続を 127.0.0.1 以外へは通さない仕掛けを先に読み込ませ、外への接続の試みが0件だったことを記録で確かめています。@strapi/strapi 本体の npm install は、取得したファイルの大きさが12秒で300MBを超えたため、そこで止めました。そのため管理画面・Content-Type Builder・実際の REST と GraphQL の応答はこの環境では動かしておらず、Strapi の公式ドキュメント(docs.strapi.io と、その元の GitHub の strapi/documentation)の記載と応答例で書いています。クエリ文字列は qs 6.17.0(@strapi/core 5.63.0 が使う版)で組み、公式の応答例を返す模擬サーバー(Node.js の http・127.0.0.1)でクライアントのコードを実行しました。版と公開日は npm view の出力、料金は strapi.io の料金ページと microCMS の料金ページで確かめ、計算は Python 3 で行いました。図は mermaid で描画を確かめています(確認日 2026年11月18日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Strapiとは|ヘッドレスCMSの使い方・料金・REST/GraphQLの呼び出し」
Strapiとは(オープンソースのヘッドレスCMS)
この節では、Strapi が何をする道具で、何を自分で用意するのかが分かります。
Strapi は、コンテンツの型を決めて入力すると、その型の REST API が自動でできるヘッドレスCMSです。 公式の REST API の説明には、コンテンツタイプを作ると API のエンドポイントが自動で作られる、と書かれています。プログラムは JavaScript・TypeScript で書かれていて、Node.js の上で動きます。
1型を作る
管理画面の Content-Type Builder で「記事」「お知らせ」などの型と項目を決める。中身は schema.json として保存される。
2入力する
Content Manager で記事を書き、下書きと公開(Draft & Publish)を分けて管理する。
3API で配る
/api/articles のような REST API が自動でできる。GraphQL はプラグインで足す。
動かす場所は2通りあります。
自分で動かす(セルフホスト)
自分のパソコン・サーバーで npm から入れる
Community プランは無料。データベースも自分で選ぶ
更新・バックアップ・サーバーの面倒も自分で見る
Strapi Cloud(提供元のホスティング)
公式の説明では、Strapi のアプリをデプロイできるホスティングの基盤
GitHub などのリポジトリからデプロイする
月額の料金がかかる(Starter 月35ドルから)
ヘッドレスCMSとは(WordPressとの違い)
ヘッドレスCMSは、画面(ヘッド)を持たず、コンテンツを API で渡すことに絞った CMS です。 WordPress のように「入力」と「ページの表示」を1つで受け持つ CMS とは、表示を別に作る点が違います。
| 比べる点 | ヘッドレスCMS(Strapi など) | 表示まで受け持つ CMS(WordPress など) |
|---|---|---|
| ページの表示 | 別に作る(Next.js・Nuxt・アプリなど) | テーマで表示まで行う |
| 配る先 | Web・アプリ・サイネージなど複数に同じデータを配れる | 主に Web サイト |
| 要るスキル | API を呼ぶ画面側の開発 | テーマの選択・設定が中心 |
| Strapi の動く環境 | Node.js(v22・v24・v26) | WordPress は PHP |
Strapiの最新版(Strapi 5)と動作要件
この節では、今の版と、インストールの前にそろえるものが分かります。
今の系列は Strapi 5 で、2026年11月18日に 5.63.0 が公開されました。 次の数字は npm view で確かめたものです。
$ npm view @strapi/strapi@latest engines --json
{
"npm": ">=6.0.0",
"node": ">=22.0.0 <=26.x.x"
}
$ npm view @strapi/strapi time --json (抜粋)
"5.0.0": "2024-09-18T15:18:06.358Z",
"4.26.2": "2026-06-09T11:00:26.604Z",
"5.60.0": "2026-10-28T10:16:55.565Z",
"5.61.0": "2026-11-04T13:09:02.711Z",
"5.62.0": "2026-11-12T16:31:24.684Z",
"5.63.0": "2026-11-18T09:14:29.830Z",
| そろえるもの | 公式の記載(2026年11月18日時点) |
|---|---|
| Node.js | Active LTS か Maintenance LTS だけ。今は v22・v24・v26(v23 などの奇数版は対象外) |
| パッケージマネージャー | npm(v6 以上)か pnpm。yarn も作成時のオプションで選べる |
| Python | SQLite を使うときに要る |
| データベース | SQLite(既定)・PostgreSQL・MySQL・MariaDB。MongoDB などの NoSQL は非対応 |
| ディスク | 公式の数字は無し。手元では依存パッケージの取得だけで300MBを超えた |
Strapi 4 は、バグ修正が2025年10月末、セキュリティ修正が2026年4月末で終わりました(Strapi の公式のお知らせ)。今から始めるなら Strapi 5 です。Strapi 4 と 5 では API の応答の形が変わっているため、ネットの記事を読むときは版を確かめます(REST APIの節で並べます)。
Node.js の版を切り替える方法は、関連記事「Node.js バージョン管理|nvm・fnm・mise・Volta比較と実測」で扱っています。
Strapiのインストールの手順(npx create-strapi)
この節では、公式の手順でプロジェクトを作って起動するまでの流れと、作成コマンドのオプションが分かります。
作成コマンドを実行する
ターミナルで npx create-strapi@latest(npm create strapi@latest でも同じ)。pnpm なら pnpm create strapi。
質問に答える
最初に Strapi Cloud へのログイン・登録か Skip かを聞かれる。ログインすると Growth プランの30日の試用が付き、Skip すると無料の CMS Free プランのまま作られる。続いてデータベース(既定は SQLite)、サンプルデータ(既定は No)、TypeScript(既定)、Git の初期化など。
起動する
プロジェクトのフォルダーで npm run develop。開発モードで起動する。
最初の管理者を作る
http://localhost:1337/admin の管理画面で、フォームに入力して最初の管理者ユーザーを作る。
手元で取得した create-strapi 5.63.0 の --help は次のとおりです(外への接続を止めた状態で実行)。
$ create-strapi --version
5.63.0
$ create-strapi --help
Usage: create-strapi-app [directory] [options]
create a new application
Options:
-V, --version output the version number
--quickstart Quickstart app creation (deprecated)
--no-run Do not start the application after it is
created.
--ts, --typescript Initialize the project with TypeScript
(default)
--js, --javascript Initialize the project with Javascript
--use-npm Use npm as the project package manager
--use-yarn Use yarn as the project package manager
--use-pnpm Use pnpm as the project package manager
--install Install dependencies
--no-install Do not install dependencies
--skip-cloud Skip cloud login and project creation
--example Use an example app
--no-example Do not use an example app
--git-init Initialize a git repository
--no-git-init Do no initialize a git repository
--non-interactive Skip all interactive prompts and use
defaults
--agent <name> Name of the coding agent that runs this
command (used for anonymous usage
statistics)
--dbclient <dbclient> Database client
--dbhost <dbhost> Database host
--dbport <dbport> Database port
--dbname <dbname> Database name
--dbusername <dbusername> Database username
--dbpassword <dbpassword> Database password
--dbssl <dbssl> Database SSL
--dbfile <dbfile> Database file path for sqlite
--skip-db Skip database configuration
--template <template> Specify a Strapi template
--template-branch <templateBranch> Specify a branch for the template
--template-path <templatePath> Specify a path to the template inside the
repository
-h, --help display help for command
| よく使うオプション | 働き(公式の説明) |
|---|---|
--skip-cloud |
Strapi へのログインとクラウドのプロジェクト作成を飛ばす |
--non-interactive |
質問をすべて飛ばして既定で作る(TypeScript・依存の導入・git・SQLite・サンプル無し)。フォルダー名が必須 |
--quickstart |
Strapi 5 では非推奨。代わりに --non-interactive |
--dbclient ほか |
sqlite・postgres・mysql を選ぶ。SQLite 以外は host・port・name・username・password をすべて渡す(一部だけだと止まる) |
--no-install |
依存パッケージを入れずにひな形だけ作る |
質問を出さずに、クラウドにも触れずに作るなら、たとえば次の形になります。
STRAPI_TELEMETRY_DISABLED=true npx create-strapi@latest my-strapi-project --non-interactive --skip-cloud
cd my-strapi-project
npm run develop
使用状況の送信(テレメトリー)を止める
Strapi は、匿名の使用状況(プロジェクトの ID・マシンの ID・環境・OS など)を送ります。 公式の説明では、データベースの設定やパスワードは集めないとされています。止める方法は3つです。
| 方法 | 書き方 | 使える時点 |
|---|---|---|
| 環境変数 | STRAPI_TELEMETRY_DISABLED=true(または 1) |
プロジェクトを作る前から |
| package.json | "strapi": { "telemetryDisabled": true } |
作ったあと |
| コマンド | npm run strapi telemetry:disable |
作ったあと |
手元では環境変数を入れて作成し、127.0.0.1 以外への接続の試みは記録されませんでした。ただし、作られた package.json には telemetryDisabled が書かれていませんでした(あったのは uuid と installId)。作成時だけ環境変数で止めても、そのあと起動するときにも同じ環境変数が無ければ止まりません。続けて止めたいなら package.json に telemetryDisabled: true を足します。公式は、以前すすめていた「uuid を消す」方法は勧めていません。
作られるプロジェクトの中身(config と .env)
依存パッケージを入れずに作ったひな形は、22ファイル・72KB でした。
Strapi v5.63.0 🚀 Let's create your new project
Strapi Creating a new application at …/my-strapi-project
Strapi Your application was created!
To get started run
cd ./my-strapi-project
npm install
npm run develop
$ find . -type f | sort
./.env
./.env.example
./.gitignore
./README.md
./config/admin.ts
./config/api.ts
./config/database.ts
./config/middlewares.ts
./config/plugins.ts
./config/server.ts
./database/migrations/.gitkeep
./favicon.png
./package.json
./public/robots.txt
./public/uploads/.gitkeep
./src/admin/app.example.tsx
./src/admin/tsconfig.json
./src/admin/vite.config.example.ts
./src/api/.gitkeep
./src/extensions/.gitkeep
./src/index.ts
./tsconfig.json
このうち、API の動きに関わる設定は次のとおりでした。
// config/api.ts(作成直後のまま)
const config: Core.Config.Api = {
rest: {
defaultLimit: 25,
maxLimit: 100,
withCount: true,
strictParams: true,
},
documents: {
strictParams: true,
strictRelations: true,
},
};
| ファイル | 作成直後の中身 | 気をつけること |
|---|---|---|
| .env | HOST=0.0.0.0・PORT=1337・鍵(APP_KEYS など6種)・DATABASE_CLIENT=sqlite | 鍵が入る。.gitignore に .env が入っていた |
| config/server.ts | host は HOST(既定 0.0.0.0)、port は PORT(既定 1337) | 手元の確認だけなら HOST=127.0.0.1 にすると外から届かない |
| config/api.ts | 1回に返すのは既定25件・最大100件 | 公式の説明どおり、新しいプロジェクトでは maxLimit が100 |
| config/database.ts | SQLite のファイルは .tmp/data.db | .tmp も .gitignore に入っていた |
| src/admin/app.example.tsx | 管理画面の言語('ja' など)がコメントで並ぶ | 日本語にするには app.tsx にして 'ja' を有効にする |
package.json の依存には @strapi/strapi・@strapi/plugin-users-permissions・@strapi/plugin-cloud・better-sqlite3 12.11.1・React 18 などが並び、npm install でこれらが入ります。
コンテンツタイプの作り方(Content-Type Builder)
この節では、記事などの型の作り方と、型から API の URL がどう決まるかが分かります。
型は3種類です。 何件も持つ「コレクション型(Collection types)」、1件だけの「シングル型(Single types)」、何度も使う部品の「コンポーネント(Components)」です。公式の手順は次のとおりです。
- 管理画面の左のメニューから Content-Type Builder を開く。
- コレクション型かシングル型の新規作成を選び、Display name(表示名)を入れる。
- API ID(単数形・複数形)が正しいかを見る。コレクション型の名前は自動で複数形になるので、単数形で名付けるのが公式のおすすめ。
- Advanced Settings で Draft & publish(下書きと公開を分ける)と Internationalization(多言語)を選ぶ。
- 項目(Text・Number・Media・Relation など)を足して Save を押す。保存すると Strapi が再起動する。
項目を1つも足さないと保存できず、型は作られません。また、型を作ったり変えたりできるのは開発モードだけです。公式の FAQ は、型の定義が schema.json というファイルに保存され、反映にはサーバーの再起動が要るため、本番やステージングでは変更できない(今後も予定は無い)と説明しています。
保存された schema.json は、たとえば次の形です(公式の項目名で手元に作ったもの)。
{
"kind": "collectionType",
"collectionName": "articles",
"info": { "singularName": "article", "pluralName": "articles", "displayName": "Article" },
"options": { "draftAndPublish": true },
"attributes": {
"title": { "type": "string", "required": true, "maxLength": 120 },
"slug": { "type": "uid", "targetField": "title" },
"body": { "type": "richtext" },
"views": { "type": "integer", "default": 0 }
}
}
公式の決まり(コレクション型は複数形、シングル型は単数形が URL になる)に沿って、schema.json から API の URL を出す小さな Python を書き、記事(コレクション型)と会社概要(シングル型)の2つで実行しました。
$ python3 routes.py my-strapi-project
# src/api/about/content-types/about/schema.json kind=singleType draftAndPublish=False
GET /api/about
PUT /api/about
DELETE /api/about
GraphQL: about
fields: heading(string)
# src/api/article/content-types/article/schema.json kind=collectionType draftAndPublish=True
GET /api/articles
POST /api/articles
GET /api/articles/:documentId
PUT /api/articles/:documentId
DELETE /api/articles/:documentId
GraphQL: article(documentId:) / articles / articles_connection
fields: title(string), slug(uid), body(richtext), views(integer)
API ID は作るときに決め、あとから変えられません(GraphQL の公式の説明)。URL に出る名前なので、最初に決めておきます。
権限の考え方(Public・Authenticated・APIトークン)
この節では、作ったばかりの API が取れない理由と、公開する範囲の決め方が分かります。
Strapi のコンテンツタイプは、既定ですべて非公開です。 公式の REST API の説明に「All content types are private by default」とあり、公開するか、権限のある認証つきのリクエストにする必要があります。
| しくみ | 誰のためのもの | 使い方 |
|---|---|---|
| Public ロール | ログインしていない利用者 | トークンなしのリクエストはこのロールの権限で扱われる。削除できない |
| Authenticated ロール | ログインした利用者 | /api/auth/local/register で登録した人に付く。JWT を Bearer で送る |
| API トークン | サーバーや外部のプログラム | Read-only・Full access・Custom を選び、期限は7日・30日・90日・無期限 |
記事を誰でも読めるようにする公式の手順(Quick Start Guide の Step 10)は次のとおりです。
- 左下の Settings を開き、Users & Permissions Plugin の Roles を選ぶ。
- Public ロールを選び、Permissions で対象の型を開く。
- find と findOne にチェックを入れ、Save を押す。
- 記事を開いて Publish を押す(既定では作った記事は下書き)。
公式のエラーの説明では、認証情報が無い・正しくないときは 401(UnauthorizedError)、権限が足りないときは 403(ForbiddenError)です。トークンなしで読みに行くと Public ロールの権限で判断されるので、find を付けていない型は 403 になります。
- 1トークンを送ったが無効 → 401期限切れ・コピーの誤り・API トークンと管理用トークンの取り違え
- 2ロールにその操作の権限が無い → 403Public に find が無い・Authenticated に create が無い
- 3権限はあるが公開版が無い → 一覧が空下書きのまま。REST は既定で公開版を返す
- 4すべて通る → 200data と meta が返る
API トークンは、権限をしぼり、長く使うものは作り直し、秘密の値の置き場に保管するよう公式が勧めています。管理画面用の Admin トークンとは別物で、互いのルートでは受け付けられません。401・403 の見分け方は、関連記事「HTTPステータスコード 一覧|全コードの原因と対処・curl実例つき」で扱っています。
Strapi REST APIの呼び出し(エンドポイントと応答の形)
この節では、REST API の URL の一覧と、Strapi 5 の応答の形、Strapi 4 の書き方との違いが分かります。
| メソッド | URL(コレクション型) | 働き |
|---|---|---|
| GET | /api/:pluralApiId |
一覧を取る(25件ずつ) |
| POST | /api/:pluralApiId |
作る(既定ですぐ公開される) |
| GET | /api/:pluralApiId/:documentId |
1件を取る |
| PUT | /api/:pluralApiId/:documentId |
更新する |
| DELETE | /api/:pluralApiId/:documentId |
消す |
シングル型は /api/:singularApiId に GET・PUT・DELETE です。呼び出しは curl でも fetch でも同じです。
curl 'http://localhost:1337/api/restaurants' \
-H 'Authorization: Bearer <token>'
公式に載っている一覧の応答は次の形です。項目(Name など)は data の中の各要素の直下にあり、ページの情報は meta.pagination に入ります。
{
"data": [
{
"id": 2,
"documentId": "hgv1vny5cebq2l3czil1rpb3",
"Name": "BMK Paris Bamako",
"Description": null,
"createdAt": "2024-03-06T13:42:05.098Z",
"updatedAt": "2024-03-06T13:42:05.098Z",
"publishedAt": "2024-03-06T13:42:05.103Z",
"locale": "en"
},
{
"id": 4,
"documentId": "znrlzntu9ei5onjvwfaalu2v",
"Name": "Biscotte Restaurant",
"createdAt": "2024-03-06T13:43:30.172Z",
"updatedAt": "2024-03-06T13:43:30.172Z",
"publishedAt": "2024-03-06T13:43:30.175Z",
"locale": "en"
}
],
"meta": {
"pagination": { "page": 1, "pageSize": 25, "pageCount": 1, "total": 2 }
}
}
この応答例をそのまま返す模擬サーバーを 127.0.0.1 に立て、画面側のコードを実行しました。Strapi 4 の書き方(attributes の中を読む)のままだと、次のように止まります。
const BASE = 'http://127.0.0.1:18667'; // 模擬サーバー(公式の応答例を返す)
(async () => {
const r = await fetch(`${BASE}/api/restaurants`);
const json = await r.json();
console.log('status', r.status, 'total', json.meta.pagination.total);
for (const item of json.data) console.log(item.documentId, item.Name); // Strapi 5 の形
const one = await fetch(`${BASE}/api/restaurants/${json.data[1].documentId}`);
console.log('GET by documentId ->', one.status, (await one.json()).data.Name);
try { console.log(json.data[0].attributes.Name); } // Strapi 4 の書き方のまま
catch (e) { console.log(e.constructor.name + ': ' + e.message); }
})();
status 200 total 2
hgv1vny5cebq2l3czil1rpb3 BMK Paris Bamako
znrlzntu9ei5onjvwfaalu2v Biscotte Restaurant
GET by documentId -> 200 Biscotte Restaurant
TypeError: Cannot read properties of undefined (reading 'Name')
Strapi 4 の記事の書き方を Strapi 5 で使うと止まる
item.attributes.title で読み、数値の id で1件を取るitem.title で読み、documentId(文字列)で1件を取る移行の途中だけは、ヘッダー Strapi-Response-Format: v4 で以前の形を返せる(公式)
公式の 404 の応答は {"data": null, "error": {"status": 404, "name": "NotFoundError", "message": "Not Found", "details": {}}} の形です。エラーはいつも error の中に status・name・message・details が入ります。curl の使い方は、関連記事「curlコマンドの使い方|オプション一覧110個と早見表・組み立てツール付き」で扱っています。
REST APIのパラメーター(filters・populate・qs)
この節では、絞り込み・関連データの展開・並べ替え・ページ分けの書き方と、qs で URL を組む方法が分かります。
| パラメーター | 働き | 例 |
|---|---|---|
| filters | 絞り込む($eq・$containsi・$in・$or など) | filters[title][$eq]=hello |
| populate | 関連・メディア・コンポーネントを展開する(既定は展開しない) | populate=* |
| fields | 返す項目を選ぶ | fields[0]=title |
| sort | 並べ替える(:asc・:desc) | sort[0]=title:asc |
| pagination | page と pageSize、または start と limit(混ぜない) | pagination[page]=1 |
| status | published(既定)か draft | status=draft |
入れ子のパラメーターは手で書くと間違えやすいため、公式は Strapi 自身も使っている qs ライブラリで組むよう勧めています。@strapi/core 5.63.0 が使う qs 6.17.0 で組んだ結果です。
const qs = require('qs');
const q = qs.stringify({
sort: ['title:asc'],
filters: { title: { $eq: 'hello' } },
populate: { author: { fields: ['firstName', 'lastName'] } },
fields: ['title'],
pagination: { pageSize: 10, page: 1 },
status: 'published',
}, { encodeValuesOnly: true });
console.log('/api/books?' + q);
qs 6.17.0 node v22.23.4
[encodeValuesOnly]
/api/books?sort[0]=title%3Aasc&filters[title][$eq]=hello&populate[author][fields][0]=firstName&populate[author][fields][1]=lastName&fields[0]=title&pagination[pageSize]=10&pagination[page]=1&status=published
[既定のエンコード] 長さ 46 /api/books?filters%5Btitle%5D%5B%24eq%5D=hello
/api/articles?filters[title][$containsi]=%E3%83%98%E3%83%83%E3%83%89%E3%83%AC%E3%82%B9
/api/articles?filters[$or][0][category][$eq]=news&filters[$or][1][views][$gte]=100
encodeValuesOnly: true を付けると角かっこが読める形で残り、付けないと %5B などに変わります。どちらもサーバーでは同じに読めます。日本語の値は UTF-8 でエンコードされます。
101件目から配列でなくなる(arrayLimit)
Strapi の query ミドルウェアは、qs の arrayLimit を既定で100にしています。 公式は、100を超える配列(101件の $in や、添字が100以上の $or)は 400 エラーになると書いています。同じ設定(arrayLimit 100・depth 20・strictNullHandling true)で qs に読ませると、境目がはっきり出ました。
n=100 URL長=2381 Array.isArray=true 型=Array 要素/キー数=100
n=101 URL長=2407 Array.isArray=false 型=Object 要素/キー数=101
filters[$or][100][title]=x -> {"filters":{"$or":{"100":{"title":"x"}}}} isArray= false
filters[$or][99][title]=x -> {"filters":{"$or":[{"title":"x"}]}} isArray= true
strictNullHandling: {"filters":{"description":{"$null":null}}} {"filters":{"description":{"$null":""}}}
101件にすると、配列ではなく「0〜100を名前にしたオブジェクト」に変わります。Strapi はこれを配列として扱えないため、400 になります。たくさんの ID で絞るときは、件数を100以下に分けるか、config/middlewares で arrayLimit を上げます(上げると1回の処理が重くなる、と公式は注意しています)。
Strapi GraphQLの呼び出し(プラグインの導入とクエリ)
この節では、GraphQL を使えるようにする手順と、Strapi 5 のクエリの書き方が分かります。
GraphQL は標準では入っていません。 プロジェクトで npm install @strapi/plugin-graphql を実行すると、/graphql のエンドポイントと、クエリを試せる画面(Apollo Server の Sandbox)ができます。5.63.0 のプラグインは graphql ^16.8.1 と @apollo/server 4.13.0 に依存していました(npm view)。
{
restaurants_connection(pagination: { page: 1, pageSize: 10 }) {
nodes {
documentId
name
}
pageInfo {
page
pageSize
pageCount
total
}
}
}
| 書き方 | 返るもの | 使う場面 |
|---|---|---|
restaurant(documentId: "…") |
1件 | 詳細ページ |
restaurants { … } |
一覧だけ(フラット) | 件数の情報が要らない一覧 |
restaurants_connection { nodes pageInfo } |
一覧とページの情報(Relay 形式) | ページ送りのある一覧 |
filters: { name: { eq: "…" } } |
絞り込み(REST と違い $ が付かない) | 検索 |
GraphQL では数値の id は出ず、documentId だけです。メディアのアップロードは GraphQL ではできず、REST の POST /upload を使います。設定は config/plugins の graphql.config に書き、既定のページの大きさは10件(defaultLimit)、上限(maxLimit)は既定で無制限、入れ子の深さの上限(depthLimit)も既定では無しです。公式は、本番では maxLimit と depthLimit を決めて書くよう勧めています。
// config/plugins.js(公式の例の値)
module.exports = () => ({
graphql: {
config: {
endpoint: '/graphql',
landingPage: false,
depthLimit: 7,
defaultLimit: 25,
maxLimit: 100,
},
},
});
REST と GraphQL のどちらを選ぶかは、関連記事「GraphQLとRESTの違い|同じ画面を両方で作ってリクエスト数を実測」で扱っています。
Strapiの料金(セルフホストとStrapi Cloud)
この節では、無料で使える範囲と、有料プランの値段、リクエスト数ごとの費用が分かります。
料金は「CMS のプラン(機能)」と「Strapi Cloud(置き場所)」の2本立てです。 金額は公式の料金ページの記載(2026年11月18日時点・ドル・税別)です。
| CMS のプラン | 月額 | 主な中身 |
|---|---|---|
| Community | 無料 | MIT ライセンス。ユーザー数・エントリー数・API 呼び出しは無制限。REST・GraphQL・ロール |
| Growth | 45ドル(3人分込み・追加1人15ドル) | Live Preview・Releases・Content History(14日)・Strapi AI 月1,000クレジット |
| Enterprise | 問い合わせ | SSO・Review Workflows・Audit Logs など |
| Strapi Cloud | 月額 | API リクエスト/月 | 違い |
|---|---|---|---|
| Starter | 35ドル | 10万 | 使われないとスリープする。バックアップ無し |
| Pro | 90ドル | 100万 | 常時起動。週1回のバックアップ |
| Business | 450ドル | 1,000万 | 毎日のバックアップ・稼働率 99.9% の SLA・環境2つ |
超えた分は、API リクエスト2万5,000件ごとに1.50ドル、ストレージ 1GB ごとに0.60ドル、転送量 100GB ごとに30ドルです。年払いにすると最大17%安くなると書かれています。この単価でリクエスト数ごとの月額を Python で計算しました。
月のAPIリクエスト | Starter | Pro | Business
50,000 | 35.00 | 90.00 | 450.00
100,000 | 35.00 | 90.00 | 450.00
200,000 | 41.00 | 90.00 | 450.00
500,000 | 59.00 | 90.00 | 450.00
800,000 | 77.00 | 90.00 | 450.00
1,000,000 | 89.00 | 90.00 | 450.00
1,200,000 | 101.00 | 102.00 | 450.00
3,000,000 | 209.00 | 210.00 | 450.00
Starter+超過 が $90 を超える最初の段: 1,025,000 90.5
Pro+超過 が $450 を超える最初の段: 7,025,000 451.5
リクエスト数だけで比べると、Starter に超過分を足しても Pro より1ドル安いままでした。 Starter と Pro の差は、スリープの有無・バックアップ・ストレージ(50GB と 250GB)・転送量(50GB と 500GB)です。お客さまが見るサイトで最初の表示が遅れては困るなら、リクエスト数ではなくスリープの有無で決めます。Growth を自分のサーバーで使う場合は、編集する人が4人で60ドル、5人で75ドル、10人で150ドルでした。
CLI でプロジェクトを作るときに Strapi Cloud へログインすると、Growth プランの30日の試用が付きます(公式)。この記事では登録もログインもしていないため、試用の画面は確かめていません。
microCMSとの違い
この節では、国内でよく比べられる microCMS との違いを、公式の記載で並べます。
| 比べる点 | Strapi | microCMS |
|---|---|---|
| 提供の形 | オープンソース(自分で動かす)と Strapi Cloud | 提供元が運用するサービス |
| 無料の範囲 | Community は機能の範囲内で利用量の上限なし(サーバー代は別) | Hobby は0円。API 5個・メンバー3人・転送量 月20GB(超えると API が止まる) |
| 有料の入口 | Growth 月45ドル・Cloud Starter 月35ドル | Team 月4,900円から(税抜) |
| データの置き場所 | 自分で選んだデータベース(SQLite・PostgreSQL・MySQL・MariaDB) | サービスの中 |
| API | REST(自動)・GraphQL(プラグイン) | REST などサービスの API |
どちらが上ということではなく、「サーバーと更新の面倒を自分で見てでも手元に置きたいか」で分かれます。microCMS の使い方と Next.js との連携は、関連記事「microCMSとは|使い方・料金・APIとNext.js連携を実例で解説」で扱っています。
Strapiのよくあるエラー・つまずき
この節では、始めたばかりのときに出やすい症状と、原因・直し方が分かります。
| 症状・表示 | 原因 | 直し方 |
|---|---|---|
| API が 403 Forbidden | Public ロールに find・findOne が無い(既定は非公開) | Settings → Users & Permissions Plugin → Roles → Public で付けて Save |
一覧が空 "data": [] |
記事が下書きのまま。REST は既定で公開版を返す | 記事を Publish する。下書きは status=draft |
| 401 Unauthorized | トークンが無効・期限切れ、API トークンと Admin トークンの取り違え | Settings の API Tokens で作り直し、Bearer で送る |
TypeError: Cannot read properties of undefined (reading 'Name') |
Strapi 4 の attributes の書き方のまま |
item.Name のように直下を読む |
| 関連・画像が返らない | 既定では populate しない | populate を付け、関連先にも find 権限を付ける |
| 400 ValidationError(ID を101個で絞った) | qs の arrayLimit(既定100)を超え、配列がオブジェクトになった | 100件以下に分けるか arrayLimit を上げる |
| 本番で型を変えられない | Content-Type Builder は開発モードだけ(仕様) | 開発で変えて、schema.json をコードとしてデプロイする |
| Node.js の版で止まる・警告が出る | engines(>=22 <=26)の外。奇数版は対象外 | v22・v24・v26 にそろえる |
| npm install でディスクが足りない | 依存が多い(手元では取得だけで300MB超) | 空き容量に余裕のある場所で作る |
JavaScript のクライアント @strapi/client 1.6.2 の engines は >=20.18.2 <=24.x.x でした(npm view)。本体は Node.js 26 に対応していても、クライアントは24までと書かれているので、v26 で使うと npm が engines の警告を出すことがあります。
公開する前に、次の4つを見ておくと、思わぬ公開や止まりを防げます。
- 1Public に付けた権限を一覧で見直すfind・findOne だけか。create・update・delete を付けていないか
- 2下書きの扱いを確かめる公開前の内容を入れる型は、status=draft を付けた取得で何が返るかを自分の環境で試す
- 3.env と鍵をリポジトリに入れない作成直後の .gitignore には .env が入っていた。消していないかを見る
- 4上限を決めるREST の maxLimit(新規は100)、GraphQL の maxLimit と depthLimit
開発中のデータを SQLite のファイルで中身から確かめる方法は、関連記事「SQLiteの使い方|コマンド早見表とPython連携を実行例で解説」で扱っています。
Strapiを選ぶかの判断表
この節では、Strapi が合う場面と、ほかの方法が合う場面が分かります。
| 状況 | 向く方法 | 理由 |
|---|---|---|
| データを自分のデータベースに置きたい | Strapi(セルフホスト) | PostgreSQL・MySQL などを自分で選べる |
| Web とアプリに同じ記事を配りたい | ヘッドレスCMS(Strapi など) | API で配るので、表示する先を選ばない |
| API の動きを自分のコードで変えたい | Strapi | コントローラー・ミドルウェア・プラグインを Node.js で書ける |
| サーバーの面倒を見る人がいない | Strapi Cloud か SaaS 型の CMS | セルフホストは更新・バックアップを自分で行う |
| お試しで小さく始めたい | 手元で Community を動かす | 無料。SQLite ならデータベースの用意も要らない |
| 表示まで1つで済ませたい・テーマで作りたい | 表示まで受け持つ CMS | ヘッドレスCMSは画面を別に作る前提 |
| Strapi 4 で動いているサイトがある | Strapi 5 への移行を計画する | Strapi 4 のセキュリティ修正は2026年4月末で終了 |
よくある質問
この節では、Strapi について検索で多い疑問に短く答えます。
Q. Strapi は無料で使えますか?
自分のパソコンやサーバーで動かす Community プランは無料で、MIT ライセンスのオープンソースです。サーバー代は別にかかります。Strapi Cloud は月35ドルの Starter からです(2026年11月18日時点)。
Q. Strapi を動かすには何が要りますか?
Node.js の v22・v24・v26 のどれかと、npm か pnpm です。SQLite を使うなら Python も要ります。データベースは SQLite(既定)・PostgreSQL・MySQL・MariaDB から選びます。
Q. 管理画面はどこで開きますか?npm run develop で起動したあと、http://localhost:1337/admin です。最初に開いたときに、最初の管理者ユーザーを作ります。
Q. API を開くと 403 になります。
コンテンツタイプは既定で非公開です。Settings の Users & Permissions Plugin → Roles → Public で、その型の find と findOne にチェックを入れて Save し、記事を Publish します。
Q. id と documentId はどちらを使いますか?
Strapi 5 では documentId(文字列)です。REST は互換のために数値の id も返しますが、1件の取得・更新・削除の URL は documentId で書きます。GraphQL には documentId しかありません。
Q. GraphQL はすぐ使えますか?
標準では入っていません。npm install @strapi/plugin-graphql を実行すると、/graphql でクエリを試せるようになります。
Q. 管理画面を日本語にできますか?
作成直後の src/admin/app.example.tsx に言語の一覧がコメントで入っていて、'ja' もあります。app.tsx として使い、'ja' を有効にします。
Q. 本番の画面でコンテンツタイプを足せないのはなぜですか?
仕様です。型の定義は schema.json というファイルで、反映にはサーバーの再起動が要るため、本番とステージングでは変えられません。開発で変えてコードとしてデプロイします。
Q. Strapi 4 の解説記事のコードがそのまま動きません。
Strapi 5 で応答の形が変わり、data.attributes の入れ子がなくなりました。data.title のように直下を読みます。移行の途中だけは Strapi-Response-Format: v4 ヘッダーで以前の形を返せます。
Q. Strapi が外へ送る情報を止められますか?
匿名の使用状況は、package.json の "strapi": { "telemetryDisabled": true }、npm run strapi telemetry:disable、作成前なら環境変数 STRAPI_TELEMETRY_DISABLED=true で止められます。
まとめ
- Strapi は Node.js 製のオープンソースのヘッドレスCMSで、型を作ると REST API が自動ででき、GraphQL はプラグインで足せます。
- 今は Strapi 5(5.63.0・2026年11月18日公開)で、Node.js は v22・v24・v26。Strapi 4 のセキュリティ修正は2026年4月末で終わりました。
- 作った API は既定で非公開です。Public ロールに find・findOne を付け、記事を Publish すると読めます。1件は documentId で引きます。
- 入れ子のクエリは qs で組むのが公式のおすすめで、配列は100件まで(arrayLimit)。101件目から配列でなくなることを手元で確かめました。
- 料金は Community が無料、Growth は月45ドル、Strapi Cloud は月35ドルから。Starter と Pro はリクエスト数よりスリープとバックアップの違いで選びます。
参考・出典
いずれも2026年11月18日に確認しました。
- Strapi「CLI installation」:https://docs.strapi.io/cms/installation/cli
- Strapi「Quick Start Guide」:https://docs.strapi.io/cms/quick-start
- Strapi「Usage information」:https://docs.strapi.io/cms/usage-information
- Strapi「REST API reference」:https://docs.strapi.io/cms/api/rest
- Strapi「REST API: Filters」:https://docs.strapi.io/cms/api/rest/filters
- Strapi「REST API: Sort & Pagination」:https://docs.strapi.io/cms/api/rest/sort-pagination
- Strapi「REST API: status」:https://docs.strapi.io/cms/api/rest/status
- Strapi「Interactive Query Builder」:https://docs.strapi.io/cms/api/rest/interactive-query-builder
- Strapi「GraphQL API」:https://docs.strapi.io/cms/api/graphql
- Strapi「GraphQL plugin」:https://docs.strapi.io/cms/plugins/graphql
- Strapi「Users & Permissions」:https://docs.strapi.io/cms/features/users-permissions
- Strapi「API Tokens」:https://docs.strapi.io/cms/features/api-tokens
- Strapi「Content-type Builder」:https://docs.strapi.io/cms/features/content-type-builder
- Strapi「Models」:https://docs.strapi.io/cms/backend-customization/models
- Strapi「API configuration」:https://docs.strapi.io/cms/configurations/api
- Strapi「Middlewares configuration」(query):https://docs.strapi.io/cms/configurations/middlewares
- Strapi「Error handling」:https://docs.strapi.io/cms/error-handling
- Strapi「FAQ」:https://docs.strapi.io/cms/faq
- Strapi「Strapi 5 has a new, flattened response format for REST API calls」:https://docs.strapi.io/cms/migration/v4-to-v5/breaking-changes/new-response-format
- Strapi Cloud「Introduction」:https://docs.strapi.io/cloud/intro
- Strapi「Pricing(Self-hosted)」:https://strapi.io/pricing-self-hosted
- Strapi「Pricing(Cloud)」:https://strapi.io/pricing-cloud
- Strapi「Notice: Strapi v4 bug support coverage is ending in October」:https://feedback.strapi.io/changelog/notice-strapi-v4-bug-support-coverage-is-ending-in-october
- ドキュメントの原文(GitHub)「strapi/documentation」:https://github.com/strapi/documentation
- npm「@strapi/strapi」:https://www.npmjs.com/package/@strapi/strapi
- qs(GitHub):https://github.com/ljharb/qs
- microCMS「料金プラン」:https://microcms.io/pricing
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Strapiとは|ヘッドレスCMSの使い方・料金・REST/GraphQLの呼び出し」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。