microCMS
ドキュメント
  • 料金プラン
  • ブログ
  • よくある質問
  • お問い合わせ
  • ログイン
  • 無料ではじめる
ナビゲーション
チュートリアル
Next.js
  • Next.jsとの連携
  • Getting Started(App Router)
  • チュートリアル(App Router)
  • Getting Started(Pages Router)
  • チュートリアル(Pages Router)
Astro
  • Astroとの連携
  • Getting Started
  • チュートリアル
Nuxt
  • Nuxtとの連携
  • Getting Started
  • チュートリアル
Gatsby
  • Gatsbyとの連携
  • Getting Started
  • チュートリアル
JavaScript
  • JavaScriptとの連携
  • Getting Started(ブラウザ)
  • Getting Started(サーバー)
PHP
  • PHPとの連携
  • Getting Started
Ruby
  • Rubyとの連携
  • Getting Started
Go
  • Goとの連携
  • Getting Started
操作マニュアル
  • はじめに
アカウントとログイン
  • アカウント登録
  • ログイン
  • メールアドレス認証をする
サービス
  • サービスの作成
  • サービス設定
  • テンプレート
  • サービスの削除
お支払い
  • 料金プランの変更
  • 決済方法の登録と変更
API
  • APIの作成・管理
  • API設定
  • APIスキーマのエクスポート/インポート
フィールド
  • テキストフィールド
  • テキストエリア
  • 画像
  • 複数画像
  • 日時
  • 真偽値
  • セレクトフィールド
  • コンテンツ参照
  • 複数コンテンツ参照
  • 数字
  • ファイル
  • カスタム
  • 繰り返し
  • 拡張フィールド
コンテンツ
  • コンテンツの作成
  • コンテンツの編集
  • コンテンツ管理
  • ビュー
  • コンテンツのステータス
  • カスタムステータス
  • コンテンツIDの設定
  • コンテンツに自動付与される値
  • コンテンツのCSVエクスポート
  • コンテンツのCSVインポート
  • APIプレビュー
  • APIプレビューを活用したクエリパラメータの利用例
  • レンダリング方式ごとの組み込み方法
  • 画面プレビュー
  • コンテンツのWebhookを設定
リッチエディタ
  • リッチエディタの操作方法
  • リッチエディタのWRITE API
  • 旧リッチエディタの操作方法
レビュー機能
  • レビュー
  • AIレビュー
メディア
  • メディア管理
  • メディアのフィルター・表示順の変更
  • メディアのタグ設定
  • メディアのWebhookを設定
  • メディアのカスタムドメイン設定
権限管理
  • メンバーの管理
  • ロール(管理画面の権限管理)
複数環境
  • 複数環境(開発環境)
  • 環境間のAPI設定のマージ
外部連携
  • Amazon S3連携
データログ
  • 監査ログ
  • データ転送量
セキュリティ
  • コンテンツの更新履歴
  • 管理画面のIP制限
  • APIのIP制限
認証設定
  • 2要素認証の設定
  • 2要素認証の必須化
  • シングルサインオン
仕様・制限事項
  • 推奨環境
  • 制限事項/注意事項
コンテンツAPI
  • コンテンツAPIとは
基本操作
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
APIキー
  • APIキー(APIの認証と権限管理)
  • 旧API(X-API-KEYなど)からの移行
レスポンスとエラー処理
  • GET APIのフィールドごとのレスポンス形式
  • GET APIにおけるクエリパラメータの指定
  • コンテンツAPIのエラーレスポンス
マネジメントAPI(ベータ)
  • マネジメントAPIとは
コンテンツ操作
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
メディア操作
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
メンバー操作
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API操作
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
  • POST /api/v1/apis
サービス操作
  • GET /api/v1/service
レスポンスとエラー処理
  • マネジメントAPIのエラーレスポンス
画像API
  • 画像APIとは
主なパラメータ
  • 画像サイズ
  • 品質
  • 解像度・画面サイズ
  • フォーマット
  • テキスト
  • 枠線
  • パディング
  • 形状
  • ダウンロード
  • ウォーターマーク
MCPサーバー
  • microCMS MCP
  • microCMS Document MCP Server
  • トップ
  • 操作マニュアル

制限事項/注意事項

最終更新日: 2026/09/07

制限事項

管理画面に関する制限事項

  • 1コンテンツあたりのデータ量:約200KB
  • 数字フィールドの入力上限値/下限値:9007199254740991/-9007199254740991
Information
  • 現在利用中のデータ量については、編集画面上部の「コンテンツ空き容量」より確認が可能です。
  • コンテンツサイズは、「公開中かつ下書き中」の場合に2つの状態の値を保持するため、最も大きくなります。「公開中」「下書き中」「公開終了」の場合は、2倍の約400KBを保持することが可能です。
  • コンテンツのサイズの計算には、内部的にデータベースに保存される情報(フィールドの種類やリッチエディタの構造情報)も含まれます。

コンテンツAPIに関する制限事項

  • GET APIのレートリミット(サービス単位):60回 / 1秒
  • WRITE API(POST / PUT / PATCH / DELETE)のレートリミット(サービス単位):5回 / 1秒
Information
  • レートリミットは、1サービスあたりの合計でカウントされます。カウント対象は、オリジンへのアクセス回数の制限となります。コンテンツAPIからのレスポンスは、CDNを経由して送信されますので、エッジサーバのキャッシュから返却した場合は、回数にカウントされません。(※キャッシュ利用の条件は、ヘルプをご参照ください。)
  • マルチテナントのシステムのため、レートリミットを超えていない場合でも、全体のリクエスト状況によっては、まれにステータスコード429(Too Many Requests)や500番台のエラーが返却される場合があります。こちらはリトライ処理を入れることで、発生確率を減らすことができます。詳しくはヘルプをご参照ください。
  • WAF(Web Application Firewall)が導入されているため、不正なリクエストだと判断された場合は、レートリミットと関係なくブロックされる場合があります。
  • レートリミットを超えた場合は、ステータスコード429(Too Many Requests)が返却されます。その場合、APIのレスポンスには以下のヘッダが含まれます。
X-RateLimit-Limit: 60 # 1秒当たりに受付可能なリクエスト数
X-RateLimit-Remaining: 13 # 受付可能な残りリクエスト数
X-RateLimit-Reset: 1648014262 # リクエスト数の計測がリセットされる時刻(UNIX時間)
  • POST / PUT APIの最大リクエストボディサイズ:約300KB
  • PATCH APIの最大リクエストボディサイズ:約90KB
  • リクエストURLの最大長:8KB
  • 最大レスポンスサイズ:約5MB
  • 最大レスポンスタイム:約29秒
Information
  • 複雑な条件の絞り込みのリクエストなどで、最大レスポンスタイムを超えた場合は、ステータスコード500番台のエラーが返却されます。

マネジメントAPI(ベータ)に関する制限事項

  • レートリミット(IPアドレス単位):10回 / 10秒
Information
  • レートリミットは、IPアドレスあたりの合計でカウントされます。マネジメントAPIからのレスポンスは、CDNを経由しないため、リクエスト数がそのままカウント対象となります。
  • マルチテナントのシステムのため、レートリミットを超えていない場合でも、全体のリクエスト状況によっては、まれにステータスコード429(Too Many Requests)や500番台のエラーが返却される場合があります。こちらはリトライ処理を入れることで、発生確率を減らすことができます。詳しくはヘルプをご参照ください。
  • WAF(Web Application Firewall)が導入されているため、不正なリクエストだと判断された場合は、レートリミットと関係なくブロックされる場合があります。
  • レートリミットを超えた場合は、ステータスコード429(Too Many Requests)が返却されます。
  • ベータ版のため、制約事項については適宜追加される可能性があります。

料金プランによって異なる制限事項

以下の項目はご利用中の料金プランによって制限事項が異なります。
詳しくは料金プランページをご確認ください。

  • データ転送量
  • メンバー数
  • API数
  • APIキー数
  • コンテンツ数
  • ビュー数
  • CSVインポート件数
  • 1メディアあたりの容量
  • IP制限(管理画面)に設定できる件数
  • IP制限(API)に設定できる1APIあたりの件数

制限値の設定がない項目

microCMSでは制限値を特に設けていない項目もございます。一例として、以下のような項目がございます。

  • サービス数
  • フィールド数
  • カスタムフィールド数
  • セレクトフィールドの項目数
  • ロール数
  • メディア数
  • メンバー数(超過した際の上限)
  • API数(超過した際の上限)
  • コンテンツの更新履歴の表示件数

これらの値については、一般的なご利用の範囲では問題ないことを確認していますが、想定より著しく多い数を設定した場合は、正常に動作しないケースも考えられます。

問題が発生した際は、大変お手数ですが、画面右下のチャット欄よりお問い合わせいただきますようお願い申し上げます。

補足(APIスキーマの保存について)

フィールドの種類や繰り返しフィールドの構造などによっては、APIスキーマ保存時に「スキーマのフィールド数が上限を超えています」というメッセージが表示され保存できない場合があります。
エラーが発生した場合は、不要なフィールドの削除・構造の見直しをご検討ください。

注意事項

ベータ版機能

ベータ版の機能については、通常の機能よりも動作が不安定な場合があります。また互換性を保たない破壊的な変更が加わる可能性が、正式版の機能よりも高くなります。

ご利用にあたっては、正常に動作しないリスクや変更が入るリスクをご検討いただいた上で、ご利用の判断をお願いします。

現在提供中のベータ版機能

  • マネジメントAPI
  • microCMS MCP

SDKの保守方針

microCMSのSDKでは、保守レベルを3段階に分類しています。
各SDKの利用にあたっては、保守レベルごとの対応範囲を確認したうえで、利用可否を判断してください。
また保守レベルは固定ではなく、利用状況や保守体制によって変更する可能性があります。

Active

Activeは、新規利用を推奨するSDKです。

不具合修正、セキュリティ対応、microCMS本体の仕様変更への追従を行います。また、対象言語、ランタイム、フレームワークのLTSバージョンで動作することを確認し、READMEや関連ドキュメントを最新の状態に保ちます。

必要に応じて、機能追加、利便性改善、依存ライブラリの更新も行います。

Maintenance

Maintenanceは、既存利用者向けに基本機能を維持するSDKです。

不具合修正、セキュリティ対応、microCMS本体の仕様変更への追従を行います。また、対象言語、ランタイム、フレームワークのLTSバージョンで動作することを確認し、READMEや関連ドキュメントを最新の状態に保ちます。

microCMS本体に破壊的変更がある場合は、必要に応じて対応します。依存ライブラリについては、セキュリティ上の問題やSDKの利用箇所に関する不具合がある場合に更新します。

一方で、新機能追加や利便性改善は原則として行いません。サンプルコードや開発時のみ利用する依存ライブラリの更新は、ベストエフォートで対応します。

Deprecated

Deprecatedは、新規利用を推奨しないSDKです。

原則として、不具合修正、セキュリティ対応、機能追加、利便性改善、microCMS本体の仕様変更への追従は行いません。また、対象言語、ランタイム、フレームワークの最新バージョンへの追従も原則として行いません。

新規開発では、代替手段の利用を検討してください。

詳細の記載が無い項目

microCMSでは詳細が記載されていない項目もございます。一例として、以下のような項目がございます。

  • APIのレスポンスヘッダ
  • APIのエラー時のステータスコード
  • Webhookのリクエストヘッダ

これらの項目については、Web・インターネット・HTTPなどの各種技術の標準的な仕様に沿った動作を想定しております。また、仕様に従う範囲内で、動作が変更される可能性があります。

ご不明な点がございましたら、画面右下のチャット欄からお問い合わせいただきますようお願い申し上げます。

目次

  • 制限事項
  • 管理画面に関する制限事項
  • コンテンツAPIに関する制限事項
  • マネジメントAPI(ベータ)に関する制限事項
  • 料金プランによって異なる制限事項
  • 制限値の設定がない項目
  • 注意事項
  • ベータ版機能
  • SDKの保守方針
  • 詳細の記載が無い項目
  • 運営会社
  • 特定商取引法に基づく表記
  • 利用規約
  • プライバシーポリシー

Copyright © microcms.io All rights reserved.