<p>リスト形式のAPIにおいてはコンテンツ一覧が取得でき、オブジェクト形式のAPIにおいては単一コンテンツの取得ができます。<br><br>オブジェクト形式のAPIの場合は<em>GET &#x2F;api&#x2F;v1&#x2F;{endpoint}&#x2F;{content_id}</em>と同様の結果が得られるので<a href="/docs/content-api/get-content" target="_blank">そちら</a>をご参照ください。<br>ここではリスト形式のAPIの場合におけるリクエストヘッダー、クエリパラメータについて解説します。<br></p><h1 id="h91d3988597">リクエストヘッダー</h1><h2 id="h8d67b5abc5">X-API-KEY</h2><p>GET APIリクエストの際に必要な認証キーです。リクエストヘッダーに含めて送信してください。</p>

<h1 id="h9ce528688c">クエリ</h1><p>URLの語尾にGETパラメータ形式で指定できます。<br></p><h2 id="hab2c474417">draftKey</h2><p>下書き状態のコンテンツを取得するためのパラメータです。 コンテンツの編集画面で確認できる<em>draftKey</em>をパラメータとして追加してください。<br></p><h2 id="h4cd61f9fa1">limit</h2><p>取得件数を指定します。<br>デフォルト値は<em>10</em>です。<br>上限値はありませんが、レスポンスサイズ（レスポンスヘッダのcontent-lengthの値）が約<em>5MB</em>を超えるとエラーが発生します。<br>そのため、大量のコンテンツの全件取得をしたい場合は下記の<em>offset</em>パラメータと組み合わせてページング処理を行ってください。<br></p><h2 id="h41838110ca">offset</h2><p>何件目から取得するかを指定します。<br>デフォルト値は<em>0</em>です。<br></p><h2 id="hf1af2f632c">orders</h2><p>取得するコンテンツの並び替えを行います。<br>並び替え対象とするフィールド名を<em>orders=publishedAt</em>といった形で指定してください。<br>複数のフィールドを並び替え対象とする場合は<em>orders=publishedAt,-updatedAt</em>のようにカンマ区切りで指定が可能です。<br><br>また降順を指定する場合はフィールド名の先頭に<em>-（マイナス）</em>を付与してください。</p><ul><li>降順：<em>-publishedAt</em></li><li>昇順：<em>publishedAt</em></li></ul><p><br>なお、並び替えが可能なのは以下のデータ型を持つフィールドのみです。<br>これ以外のフィールドを指定しても無視されます。</p><ul><li>日付</li><li>真偽値（true or false）</li><li>数値</li></ul><p><br></p><h2 id="ha8abec0b2f">q</h2><p><span style="color:#24292e">コンテンツの全文検索を行います。</span><br><span style="color:#24292e">下書き状態のコンテンツは検索対象には含まれません。</span><br></p><h2 id="h7462d83de4">fields</h2><p>コンテンツの中で取得する要素を指定します。<br><em>fields=title,main_image,updatedAt,author.name</em>のようにカンマ区切りで値を記載してください。<em>author.organization.name</em>のようにドットでつないでキーを指定することで参照コンテンツの要素も指定できます。<em>fields</em>が指定されていない場合は全ての要素を取得します。<br></p><h2 id="h6b992e0fe4">ids</h2><p>コンテンツのidを<em>first_id,second_id,third_id</em>のようにカンマ区切りで指定することで対象コンテンツのみを取得できます。 <br>取得できる最大件数は100件です。<br><br><em>filters</em>や<em>q</em>など一部のパラメータとの併用はできませんのでご注意ください。<br></p><h2 id="hdebbdc8e86">filters</h2><p>公開されているコンテンツの中から取得するコンテンツを絞り込みます。<br>ただし下書き状態のコンテンツやリッチテキストについては絞り込みの対象外です。<br><br>利用できる条件式は以下の通りです。<br></p><h3 id="hf768a2fd4d">equals</h3><p>指定に一致したコンテンツを取得します。<br>（例：<em>gender[equals]women</em>）<br></p><h3 id="h233ee09eb0">not_equals</h3><p>指定に一致しないコンテンツを取得します。<br>（例：<em>gender[not_equals]women</em>）<br></p><h3 id="hbc115dc003">less_than</h3><p>指定より小さいコンテンツを取得します。<br>（例：<em>createdAt[less_than]2019-11</em>）<br></p><h3 id="h40c49a5760">greater_than</h3><p>指定より大きいコンテンツを取得します。<br>（例：<em>createdAt[greater_than]2019-10</em>）<br></p><h3 id="hfe668245b0">contains</h3><p>指定した値を含むコンテンツを取得します。<br>（例：<em>title[contains]おすすめ</em>）<br></p><h3 id="h7c2df9171b">exists</h3><p>指定した値が存在するコンテンツを取得します。<br>（例：<em>nextLink[exists]</em>）<br></p><h3 id="h0b8e0ad809">not_exists</h3><p>指定した値が存在しないコンテンツを取得します。<br>（例：<em>nextLink[not_exists]</em>）<br></p><h3 id="hcd3e2ddb48">begins_with</h3><p>指定した値から始まるコンテンツを取得します。<br>（例：<em>publishedAt[begins_with]2019-11</em>）<br><br>なおコンテンツ参照については単数の場合は<em>[equals]</em>のみが利用可能です。<br>（例：<em>category[equals]uN28Folyn</em>）<br><br>複数の場合は<em>[contains]</em>のみが利用可能です。（例：<em>tags[contains]oJIZmiban</em>）<br><br>{VALUE}部分に対象のコンテンツのidを入力してください。<br><br>また、式は<em>[and]</em>（AND条件) もしくは<em>[or]</em>（OR条件)で 区切ることで複数指定ができます。<br>複数指定した場合は基本的には左から右に順に評価されますが、<em>[and]</em>と<em>[or]</em>が混在した場合については<em>[and]</em>が優先されます。<br>条件式を括弧<em>()</em>で囲って一部の式を優先させることもできますので、適切な値が取れるよう優先順位をコントロールしてください。<br><br>例：カテゴリーがエンジニアリングかつ、2019&#x2F;11&#x2F;14以降またはタイトルが存在している記事を抽出</p><pre><code>$curl --glob &quot;https:&#x2F;&#x2F;{your-service}.microcms.io&#x2F;api&#x2F;v1&#x2F;blog?filters=category[equals]engineering[and](date[begins_with]2019-11-14[or]title[exists])&quot; -H &quot;X-API-KEY: {api-key}&quot;</code></pre><p><br></p><h2 id="h30fce9c966">depth</h2><p>参照コンテンツを取得する階層の深さを指定します。<br>デフォルト値は<em>1</em>、最大値は<em>3</em>です。<br><br>例えば、ブログコンテンツに関連記事を表示するために、自分自身を循環参照しているとします。<br><br>例）<em>depth = 1</em>の場合</p><pre><code>{
  &quot;id&quot;: &quot;id1&quot;,
  &quot;title&quot;: &quot;title1&quot;,
  &quot;body&quot;: &quot;body1&quot;,
  &quot;related_blog&quot;: {
    &quot;id&quot;: &quot;id2&quot;,
    &quot;title&quot;: &quot;title2&quot;,
    &quot;body&quot;: &quot;body2&quot;,
    &quot;related_blog&quot;: {
      &quot;id&quot;: &quot;id3&quot;
    }
  }
}</code></pre><p><br>例）<em>depth = 2</em>の場合</p><pre><code>{
  &quot;id&quot;: &quot;id1&quot;,
  &quot;title&quot;: &quot;title1&quot;,
  &quot;body&quot;: &quot;body1&quot;,
  &quot;related_blog&quot;: {
    &quot;id&quot;: &quot;id2&quot;,
    &quot;title&quot;: &quot;title2&quot;,
    &quot;body&quot;: &quot;body2&quot;,
    &quot;related_blog&quot;: {
      &quot;id&quot;: &quot;id3&quot;,
      &quot;title&quot;: &quot;title3&quot;,
      &quot;body&quot;: &quot;body3&quot;,
      &quot;related_blog&quot;: {
        &quot;id&quot;: &quot;id4&quot;
      }
    }
  }
}</code></pre><p><br></p>

GET /api/v1/{endpoint}

<p>リスト型APIにおいて、idで指定したコンテンツを取得できるAPIです。<br></p><h1 id="h91d3988597">リクエストヘッダー</h1><h2 id="h8d67b5abc5">X-API-KEY</h2><p>GET APIリクエストの際に必要な認証キーです。リクエストヘッダーに含めて送信してください。</p>

<h1 id="h9ce528688c">クエリ</h1><p>URLの語尾にGETパラメータ形式で指定できます。<br></p><h2 id="hab2c474417">draftKey</h2><p>下書き状態のコンテンツを取得するためのパラメータです。 コンテンツの編集画面で確認できる<em>draftKey</em>をパラメータとして追加してください。<br></p><h2 id="h7462d83de4">fields</h2><p>コンテンツの中で取得する要素を指定します。<br><em>fields=title,main_image,updatedAt,author.name</em>のようにカンマ区切りで値を記載してください。<em>author.organization.name</em>のようにドットでつないでキーを指定することで参照コンテンツの要素も指定できます。<em>fields</em>が指定されていない場合は全ての要素を取得します。<br></p><h2 id="h30fce9c966">depth</h2><p>参照コンテンツを取得する階層の深さを指定します。<br>デフォルト値は<em>1</em>、最大値は<em>3</em>です。<br><br>例えば、ブログコンテンツに関連記事を表示するために、自分自身を循環参照しているとします。<br><br>例）<em>depth = 1</em>の場合</p><pre><code>{
  &quot;id&quot;: &quot;id1&quot;,
  &quot;title&quot;: &quot;title1&quot;,
  &quot;body&quot;: &quot;body1&quot;,
  &quot;related_blog&quot;: {
    &quot;id&quot;: &quot;id2&quot;,
    &quot;title&quot;: &quot;title2&quot;,
    &quot;body&quot;: &quot;body2&quot;,
    &quot;related_blog&quot;: {
      &quot;id&quot;: &quot;id3&quot;
    }
  }
}</code></pre><p><br>例）<em>depth = 2</em>の場合</p><pre><code>{
  &quot;id&quot;: &quot;id1&quot;,
  &quot;title&quot;: &quot;title1&quot;,
  &quot;body&quot;: &quot;body1&quot;,
  &quot;related_blog&quot;: {
    &quot;id&quot;: &quot;id2&quot;,
    &quot;title&quot;: &quot;title2&quot;,
    &quot;body&quot;: &quot;body2&quot;,
    &quot;related_blog&quot;: {
      &quot;id&quot;: &quot;id3&quot;,
      &quot;title&quot;: &quot;title3&quot;,
      &quot;body&quot;: &quot;body3&quot;,
      &quot;related_blog&quot;: {
        &quot;id&quot;: &quot;id4&quot;
      }
    }
  }
}</code></pre><p><br></p>

GET /api/v1/{endpoint}/{content_id}

<p>POST APIを用いることで、コンテンツの入稿をAPI経由で行うことができます。<br><a href="https://microcms.io/pricing" target="_blank">プラン</a>によってPOST APIのリクエスト上限数は異なります。<br></p><h1 id="h91d3988597">リクエストヘッダー</h1><h2 id="h0f55d7d60a">X-WRITE-API-KEY</h2><p>POST, PUT, PATCH, DELETE APIリクエストの際に必要な認証キーです。<br>リクエストヘッダーに含めて送信してください。<br>未使用の場合は削除しておくことを推奨します。</p>

<h2 id="h82d2472f5c">Content-Type</h2><p>送信するデータの形式を指定します。<br>microCMSではJSON形式のデータのみ扱っているため、<em>application&#x2F;json</em>と指定してください。<br></p><h1 id="h44fdca3bb7">リクエストボディ</h1><p>APIスキーマに沿って送信したい内容のJSONを用意し、文字列として渡してください。<br>例：</p><pre><code>{&quot;title&quot;:&quot;bodyサンプル&quot;,&quot;publishedAt&quot;:&quot;2020-04-23T14:32:38.163Z&quot;}</code></pre><p>各フィールドにおける値の指定方法は下記の通りです。<br></p><h3 id="h6165104509">テキストフィールド</h3><p>任意の文字列を指定してください。<br>（例：&quot;テキスト1&quot;）<br></p><h3 id="h2289ee5a1d">テキストエリア、リッチエディタ</h3><p>改行コードを用いることで複数行の文字列を指定できます。<br>（例：&quot;複数行のテキストを入力\n複数行のテキストを入力&quot;）<br></p><h3 id="hd924fb81c3">画像、ファイル、カスタムフィールド、繰り返しフィールド</h3><p>非対応です。指定しても空になります。<br></p><h3 id="h1e35956891">日時</h3><p>ISO 形式 (ISO 8601) の文字列で指定してください。<br>（例：&quot;2020-04-23T14:32:38.163Z&quot;）<br></p><h3 id="hcd3ae79fbe">数字</h3><p>数字を指定してください。<br>（例：123）<br></p><h3 id="hac16e128af">真偽値</h3><p>真偽値を指定してください。<br>（例：true）<br></p><h3 id="h9c184228ff">コンテンツ参照</h3><p>参照先コンテンツのcontentIdを指定してください。<br>（例：&quot;参照先id&quot;）<br></p><h3 id="h909b716ba0">コンテンツ複数参照</h3><p>参照先コンテンツのcontentIdを配列で指定してください。<br>（例：[&quot;参照先id1&quot;,&quot;参照先id2&quot;]）</p>

POST /api/v1/{endpoint}

品質

<p>microCMSにはコンテンツAPI以外にも画像APIが備わっています。<br>画像アップロード後に、画像URLにパラメータを付与することで様々な編集が可能です。<br><br>画像フィールドからのアップロード、リッチエディタ内からのアップロード共に対応しています。<br><br>画像処理にはImgixのAPIを利用しています。<br>APIに関して詳しく知りたい方はImgixの<a href="https://docs.imgix.com/apis/url" target="_blank" rel="noopener noreferrer">公式リファレンス</a>をご覧ください。</p>

画像APIとは

<h2 id="h84865a8759">w</h2><p>画像のwidthを指定します。<br>例）<em>?w=200</em></p>

<h2 id="h7ec8040a52">h</h2><p>画像のheightを指定します。<br>例）<em>?h=200</em></p>

<h2 id="h835cbba716">fit</h2><p>画像の縦横比調整、切り取りや表示領域の最適化を行います。<br>デフォルトは<em>clip</em>です。<br></p><h3 id="h769ee70f73">fit=clip</h3><p>画像の縦横比を固定してリサイズします。<br>例）<em>?fit=clip&amp;w=200&amp;h=200</em></p>

<h3 id="hb0dd2b7f33">fit=clamp</h3><p>画像の切り抜きや歪みなしに指定した画像サイズにフィットさせます。 上下左右の端のピクセルを延長させた形になります。<br>例）<em>?fit=clamp&amp;w=200&amp;h=300</em></p>

<h3 id="h91cc482d1f">fit=crop</h3><p>画像を指定したサイズに拡大・縮小後・余白部分は切り落とします。<br>wとhの指定が必須です。<br>例）<em>?fit=crop&amp;w=200&amp;h=200</em></p>

<p>cropクエリを用いるとさらに詳細を設定できます。<br>例）<em>?fit=crop&amp;crop=left,top&amp;w=200&amp;h=200</em></p>

<h3 id="heee6a29066">fit=fill</h3><p>画像を指定したサイズに収まるように配置します。<br>余白部分を<em>fill-color</em>で補います。<br>また、<em>fill=blur</em>を用いるとブラー画像を背景に配置することもできます。<br>例）<em>?fit=fill&amp;fill-color=3331cbf&amp;w=200&amp;h=200</em></p>

<h3 id="hd8306bc24a">fit=fillmax</h3><p>元画像以上のサイズ指定を行い、画像をその中央に配置します。<br>余白部分を<em>fill-color</em>で補います。<br>また、<em>fill=blur</em>を用いるとブラー画像を背景に配置することもできます。<br>例）<em>?fit=fillmax&amp;fill-color=3331cbf&amp;w=700&amp;h=400</em>（元画像は600x300）</p>

<h3 id="h5cebc6ede9">fit=max</h3><p>指定したサイズ内に縦横比を固定しつつ画像を最大限配置します。<br>例）<em>?fit=max&amp;w=200&amp;h=200</em></p>

<h3 id="h882590aec2">fit=scale</h3><p>指定したサイズに画像を拡大・縮小します。<br>縦横比は維持されません。<br>例）<em>?fit=scale&amp;w=200&amp;h=200</em></p>

画像サイズ

<h2 id="ha8abec0b2f">q</h2><p>画像の出力品質を制御します。<em>0~100</em>で値を指定できます。デフォルト値は<em>75</em>です。<br>例）<em>?q=0</em></p>

<h3 id="h5fbe6cc314">dpr</h3><p>画像の出力密度を制御します。<br>これによって一つの画像からあらゆるデバイスに対して正しいサイズの画像を配信できます。 <br>デフォルト値は<em>1</em>で最大で<em>8</em>まで入力できます。 <br><br>また、dprパラメータを指定する際には高さや幅も指定してください。<br>このパラメータは画面サイズ別に画像を利用したい場合に適しています。<br>例えば以下のようにsrcset指定での利用が考えられます。</p><pre><code>&lt;img
    srcset=&quot;https:&#x2F;&#x2F;xxxxxx&#x2F;sample.png?h=300&amp;w=500&amp;dpr=1 1x,
        https:&#x2F;&#x2F;xxxxxx&#x2F;sample.png?h=300&amp;w=500&amp;dpr=2 2x,
        https:&#x2F;&#x2F;xxxxxx&#x2F;sample.png?h=300&amp;w=500&amp;dpr=3 3x&quot;
    src=&quot;https:&#x2F;&#x2F;xxxxxx&#x2F;sample.png?h=300&amp;w=500&amp;dpr=1&quot;
&#x2F;&gt;</code></pre><p>例）<em>?dpr=2&amp;w=300</em></p>

解像度・画面サイズ

<h2 id="h5d78138f6c">fm=json</h2><p>画像のメタ情報を取得します。<br>例）<em>?fm=json</em></p><pre><code>{
  &quot;Content-Type&quot;: &quot;image&#x2F;png&quot;,
  &quot;Output&quot;: {},
  &quot;ColorModel&quot;: &quot;RGB&quot;,
  &quot;Content-Length&quot;: &quot;104152&quot;,
  &quot;Depth&quot;: 8,
  &quot;PNG&quot;: {
    &quot;InterlaceType&quot;: 0,
    &quot;sRGBIntent&quot;: 0,
    &quot;Gamma&quot;: 0.45455,
    &quot;Chromaticities&quot;: [
      0.3127,
      0.329,
      0.64,
      0.33,
      0.3,
      0.6,
      0.15,
      0.06
    ]
  },
  &quot;PixelHeight&quot;: 300,
  &quot;PixelWidth&quot;: 600,
  &quot;ProfileName&quot;: &quot;sRGB IEC61966-2.1&quot;
} </code></pre><h3 id="hcf83e1357e"><br></h3><h2 id="hcaa678afb4">fm=webp</h2><p>画像をWebP形式に変換します。<br></p>

フォーマット

<h3 id="hec6a971011">txt</h3><p>テキストを画像にオーバーレイします。<br>テキストを表示するためにはこの値が必須です。<br>設定されていない場合、他のすべてのテキストパラメータは無視されます。<br>例）<em>?txt=Hello%20World!</em><br></p>

<p><br>例）<em>?txt=HELLO%20WORLD!&amp;txt-size=62&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-font=Futura%20Condensed%20Medium</em></p>

<h2 id="h4bd3ec5548">txt-align</h2><p>画像内のテキストオーバーレイの配置を設定します。<br>縦方向は<em>top</em>,<em>middle</em>,<em>bottom</em>、横方向は<em>left</em>,<em>center</em>,<em>right</em>が選択できます。<br>デフォルトは<em>bottom</em>,<em>right</em>です。<br>例）<em>?txt=Hello%20World!&amp;txt-align=middle,center</em></p>

<h2 id="h73ef87510f">txt-clip</h2><p>表示領域を超えたテキストを切り取ります。<br><em>start</em>,<em>middle</em>,<em>end</em>から切り取る位置を指定し、ellipsisの有無で「...」の表示が可能です。<br>デフォルトは<em>end</em>です。<br>また、<em>txt-pad</em>,<em>txt-width</em>を用いることで表示領域をコントロールすることができます。<br>例）<em>?txt=ABCDEFGHIJKLMNOPQRSTUVWXYZ&amp;txt-size=62&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-clip=end,ellipsis</em><br></p>

<p><br>例）<em>?txt=ABCDEFGHIJKLMNOPQRSTUVWXYZ&amp;txt-size=62&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-clip=middle</em></p>

<h2 id="h247bb74dfa">txt-color</h2><p>文字色を指定できます。<br><em>RGB</em>,<em>ARGB</em>,<em>RRGGBB</em>,<em>AARRGGBB</em>, の16進数形式で指定します。<br><em>A</em>はアルファ値（透過値）、<em>RGB</em>はそれぞれ赤&#x2F;緑&#x2F;青を表す値です。<br>デフォルトは<em>000</em>です。<br>例）<em>?txt=microCMS&amp;txt-size=62&amp;txt-color=99ffffff&amp;txt-align=middle,center</em><br></p>

<h2 id="ha88acd4f49">txt-fit</h2><p>テキストを表示領域にフィットさせます。<br><em>max</em>のみ指定できます。<br>デフォルトは指定なしです。<br>例）<em>?txt=ABCDEFGHIJKLMNOPQRSTUVWXYZ&amp;txt-size=62&amp;txt-color=fff&amp;txt-align=middle,center&amp;txt-fit=max</em><br></p>

<h2 id="hbd544cc5d9">txt-font</h2><p>テキストのフォントを指定できます。<br>CSSのカテゴリ指定（<em>serif</em>,<em>sans-serif</em>,<em>monospace</em>,<em>cursive</em>,<em>fantasy</em>）、または明示的なフォント名を指定可能です。<br>太字、イタリックについてもカンマつなぎで<em>bold</em>,<em>italic</em>を指定可能です。<br>例）<em>?txt=microCMS&amp;txt-size=62&amp;txt-color=fff&amp;txt-align=middle,center&amp;txt-font=Helvetica%20Neue</em><br></p>

<p><br>例: <em>?txt=microCMS&amp;txt-size=62&amp;txt-color=fff&amp;txt-align=middle,center&amp;txt-font=serif,italic</em></p>

<h2 id="h1aebc2e14a">txt-size</h2><p>文字サイズを指定できます。<br>デフォルト値は<em>12</em>です。<br>例）<em>?txt=microCMS&amp;txt-size=24&amp;txt-color=fff&amp;txt-align=middle,center</em><br></p>

<h2 id="h6d27006b5d">txt-line</h2><p>テキストをアウトライン幅を指定できます。<br>アウトラインはテキストの内側に描画されます。<br>デフォルト値は<em>0</em>です。<br>例）<em>?txt=microCMS&amp;txt-size=70&amp;txt-color=0000&amp;txt-align=middle,center&amp;txt-line=2</em><br></p>

<h2 id="hedb794e185">txt-line-color</h2><p>テキストのアウトライン色を指定できます。<br><em>txt-line</em>とセットで用いてください。<br><em>RGB</em>,<em>ARGB</em>,<em>RRGGBB</em>,<em>AARRGGBB</em>, の16進数形式で指定します。<br><em>A</em>はアルファ値（透過値）、<em>RGB</em>はそれぞれ赤&#x2F;緑&#x2F;青を表す値です。<br>デフォルトは<em>fff</em>です。<br>例）<em>?txt=microCMS&amp;txt-size=70&amp;txt-color=0000&amp;txt-align=middle,center&amp;txt-line=2&amp;txt-line-color=ffc427</em><br></p>

<h2 id="h2f8b1f1d30">txt-pad</h2><p>テキスト周りの余白を指定できます。<br>デフォルトは<em>10</em>です。<br>例）<em>?txt=microCMS&amp;txt-pad=20</em><br></p>

<p><br>例）<em>?txt=ABCDEFGHIJKLMNOPQRSTUVWXYZ&amp;txt-size=62&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-clip=end,ellipsis&amp;txt-pad=50</em><br></p>

<h2 id="hda7bb2a002">txt-shad</h2><p>テキストに陰影をつけます。<br><em>0</em>-<em>10</em>のパラメータで指定します。<br>デフォルトは<em>0</em>です。<br>例）<em>?txt=HELLO%20WORLD!&amp;txt-size=32&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-shad=5</em><br></p>

<h2 id="h155f33cd14">txt-width</h2><p>テキストの横幅を指定します。<br>テキスト領域を超えた場合は自動的に切り取られます。<br><em>txt-clip</em>パラメータを用いることで切り取られ方を調整できます。<br>デフォルト値は画像の横幅によって自動計算されます。<br>例）<em>?txt=HELLO%20WORLD!&amp;txt-size=32&amp;txt-color=ffffff&amp;txt-align=middle,center&amp;txt-width=200</em><br></p>

テキスト

<p>microCMSはAPIベースの日本製ヘッドレスCMSです。<br>ヘッドレスCMSについてはこちらの記事をご参考ください。</p>

<h1 id="h6c72713731">microCMSの始め方</h1><p>microCMSは次のようなステップで始めることができます。</p><ol><li><a href="/docs/manual/signup">アカウント登録</a></li><li><a href="/docs/manual/signin">ログイン</a></li><li><a href="/docs/manual/create-service">サービスの作成</a></li><li><a href="/docs/manual/create-api">APIの作成</a></li><li><a href="/docs/manual/create-content">コンテンツの作成</a></li><li><a href="/docs/manual/api-request">APIの呼び出し</a></li><li><a href="/docs/manual/display-contents">コンテンツをブラウザで表示する</a></li></ol><p><br></p>

<p>まずはアカウントの登録が必要です。<br><a href="https://app.microcms.io" target="_blank">アカウント登録画面</a>から登録を行ってください。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/signup-01.png" alt><br><br>パスワードの条件は以下になります。</p><ul><li>半角英数</li><li>8文字以上</li><li>大文字、小文字、数字を含む</li></ul><p><br>登録するボタンをクリック後は、入力したメールアドレスに2段階認証コードが送信されます。<br>次の画面で入力してください。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/signup-02.png" alt><br><br>無事入力が完了すれば、アカウント登録は完了です。</p>

アカウント登録

はじめに

<p><a href="https://app.microcms.io/signin" target="_blank">ログイン画面</a>からログインすることができます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/signin-01.png" alt><br><br>メールアドレス、パスワードを入力してログインしてください。<br></p><h1 id="h03e644dc44">パスワードを忘れてしまった場合</h1><p><a href="https://app.microcms-dev.net/forgot-password" target="_blank">パスワード再設定申請画面</a>にアクセスしてください。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/signin-02.png" alt><br><br>入力したメールアドレス宛てにパスワード再設定用の認証コードが送られます。<br>次の画面で認証コードを入力すれば再設定は完了です。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/signin-03.png" alt></p>

<p>アカウント登録、ログイン後はサービスを作成しましょう。<br><br>サービスはmicroCMSの中で最上位の概念です。<br>サービス &gt; API &gt; コンテンツという階層構造になっています。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-service-01.png" alt><br><br>まずはサービス情報の入力です。<br>サービス名にはmicroCMSの導入を考えているプロダクト名や組織名を入力すると良いでしょう。<br>サービスIDは管理画面のURL、APIのエンドポイントのサブドメインに設定される値です。<br>サービスIDは一度設定すると変更ができないので慎重に決めましょう。（どうしても変更しなければならない場合はお問い合わせください）<br><br>例として、架空の株式会社マイクロというサービスを作ってみます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-service-02.png" alt><br><br>次の画面ではサービス画像を選択することができます。<br>サービス画像を設定すると管理画面の一番左の列に表示されます。<br>画面右下のボタンをクリックすれば、画像設定をスキップすることもできます。（後からでも設定が可能です）<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-service-03.png" alt><br><br>画像の設定が終われば、サービスの作成は完了です。<br>ここから先はサービスIDを microcms.io のサブドメインとしてアクセスできるようになります。</p>

サービスの作成

<p>APIの作成について解説していきます。<br>APIはサービスごとに複数作成することができます。<br>（<a href="https://microcms.io/pricing" target="_blank">プラン</a>ごとに作成できるAPI数の上限は異なります。）<br><br>まずは基本情報の入力です。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-api-01.png" alt><br><br>ここでは、API名 &#x2F; エンドポイントの2つを入力します。<br><br>API名は管理画面上で各APIを識別するために設定する名前になります。<br>エンドポイントはAPIのエンドポイントの最後尾のパスにあたる値です。<br>エンドポイントの入力条件は以下になります。</p><ul><li>3文字以上20文字以内</li><li>半角英数字</li><li>小文字のみ</li><li>記号はハイフン、アンダースコアのみ</li><li>すでに設定済みのAPIエンドポイントとの重複不可</li></ul><p><br>ここでは例として、お知らせ情報を取得するAPIを作成します。<br>次に、APIのレスポンス形式の指定です。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-api-02.png" alt><br><br>ここではAPIレスポンスをリスト形式で返すか、オブジェクト形式で返すか選択することができます。<br></p><h2 id="hfab6db4976">リスト形式</h2><p>複数のコンテンツを取り扱います。<br>お知らせやブログなどの複数コンテンツの管理に適しています。<br>APIでは下記のように配列データを取得できます。</p><pre><code>[ { message: &#x27;おはよう&#x27; }, { message: &#x27;こんにちは&#x27; }, { message: &#x27;こんばんは&#x27; } ]</code></pre><h4 id="hcf83e1357e"><br></h4><h2 id="ha3b9fbc8d9">オブジェクト形式</h2><p>単一のコンテンツを取り扱います。<br>設定情報や単体ページの情報などの単一コンテンツの管理に適しています。<br>APIでは下記のようにオブジェクトデータを取得できます。</p><pre><code>{ title: &#x27;プロフィール&#x27;, profile: &#x27;ヘッドレスCMSを勉強しています&#x27; }</code></pre><p><br>例として、お知らせ情報は複数コンテンツから成り立つのでリスト形式を選択します。<br>次にAPIスキーマの設定です。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-api-03.png" alt><br><br>APIレスポンスの構造を決めることができます。<br>下記3つの項目を入力します。<br></p><h3 id="h8e35157ab0">フィールドID</h3><p>APIレスポンスのプロパティ名です。<br></p><h3 id="h5b5474cb91">表示名</h3><p>コンテンツを入力する際に表示されます。<br></p><h3 id="he665b3e0a1">種類</h3><p>コンテンツを入力する際の入力フォームを指定することができます。<br>テキストフィールド、リッチエディタ、画像選択フォームなど様々な種類から選択可能です。<br><br>以上でAPIの作成は完了です。</p>

APIの作成

<p>コンテンツの作成について、<a href="/docs/manual/create-api" target="_blank">APIの作成</a>で用意したAPIを元に解説していきます。<br></p><h1 id="h95b40124ab">APIがリスト形式の場合</h1><p>まずはAPIをリスト形式として作成した場合について解説します。<br>画面上部のコンテンツ管理タブをクリックするとコンテンツ一覧画面が表示されます。<br>画面右上の追加ボタンをクリックすることでコンテンツ作成画面に遷移できます。<br><br>コンテンツ作成画面ではAPIスキーマで設定した内容に合わせて入稿フォームが用意されます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/create-content-01.png" alt><br><br>内容を入力し、右上の公開ボタンにある三角マークをクリックすると、公開または下書き保存のどちらかを行うことができます。<br>公開を選択し、クリックするとコンテンツは公開され、APIから取得できるようになります。<br></p><h1 id="h2dd72095e8">APIがオブジェクト形式の場合</h1><p>APIをオブジェクト形式として作成した場合は、単一コンテンツのみが入稿可能となります。<br>よって、画面上部のコンテンツ管理タブをクリックしてもコンテンツ一覧画面には遷移せず、最初からコンテンツ作成&#x2F;編集画面に遷移します。<br><br>コンテンツ作成画面における操作はリスト形式の際と同じです。<br>ただし、オブジェクト形式の場合は単一コンテンツのため、コンテンツの削除ボタンが用意されていません。<br>コンテンツを削除したい場合はAPI設定からAPIごと削除してください。</p>

コンテンツの作成

<p>コンテンツを作成した後は、API経由でコンテンツを取得してみましょう。<br></p><h1 id="h1b04a6654a">単一コンテンツの取得</h1><p>コンテンツをひとつだけ取得したい場合は、次のエンドポイントを利用します。<br><br><em>GET &#x2F;api&#x2F;v1&#x2F;{endpoint}&#x2F;{content_id}</em></p>

<p>APIを呼び出すためには<strong>API-KEYが必要です</strong>。<br>API-KEYはサービス設定 &gt; API-KEYから確認可能です。<br>（サービス設定画面には、画面左上のサービス名をクリックすることで遷移することができます。）<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/api-request-03.png" alt><br><br>また、microCMSには管理画面上で簡単にAPIを試すことができる「APIプレビュー」機能が標準で搭載されています。<br>コンテンツ編集画面の右上に「APIプレビュー」ボタンがあるのでクリックしてみましょう。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/api-request-01.png" alt><br><br>既にデータ取得リクエストの準備は整っています。<br>画面内の「取得」ボタンを押してみましょう。<br>実際にブラウザからAPIリクエストが行われ、次のようなJSONレスポンスが表示されます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/api-request-02.png" alt><br><br>また、画面内にはAPIを叩くためのcurlコマンドも表示されています。<br>こちらで直接データを取得することも可能です。<br></p><pre><code>$ curl &quot;https:&#x2F;&#x2F;micro.microcms.io&#x2F;api&#x2F;v1&#x2F;news&#x2F;FwVfA_GeL&quot; -H &quot;X-API-KEY: 1598164e-2d58-488c-a4af-c51bd7d131a5&quot;</code></pre><p><br>そのほかAPI仕様の詳細については<a href="/docs/content-api/get-content">コンテンツAPIリファレンス</a>をご覧ください。</p>

<h1 id="hb89ab674d4">コンテンツ一覧の取得</h1><p>リスト形式のAPIでは次のエンドポイントを利用することで、コンテンツ一覧の取得を行うことも可能です。<br><br><em>GET &#x2F;api&#x2F;v1&#x2F;{endpoint}</em><br></p>

<p><br>こちらのAPIに関しても、コンテンツ一覧画面右上の「APIプレビュー」ボタンから実行が可能です。<br><br>リスト形式のAPIでは入稿したコンテンツが配列で返ってくると共に、<em>totalCount</em>、<em>offset</em>、<em>limit </em>が返却されます。<br><br>コンテンツ一覧取得APIはクエリが豊富で、フィールド指定や複雑なフィルタリングを行うことができます。</p>

<p>コンテンツをAPIから取得することができたら、実際にそのデータをブラウザで表示してみましょう。<br><br>※microCMSで取得できるのはJSONデータのみのため、ユーザーに内容を見せるためには何らかの表示ロジックが必要です。<br><br>ここではサンプルとして HTML&#x2F;JavaScript を使って表示してみます。<br>実際にはAPIさえ呼び出せればデータ表示をするプラットフォームは何でも構いません。<br><br>こちらが今回作成した index.html です。<br></p><pre><code>&lt;!DOCTYPE html&gt;
&lt;html lang=&quot;ja&quot;&gt;
  &lt;body&gt;
    &lt;main&gt;
      &lt;h1 id=&quot;title&quot;&gt;&lt;&#x2F;h1&gt;
      &lt;div id=&quot;body&quot;&gt;&lt;&#x2F;div&gt;
    &lt;&#x2F;main&gt;
    &lt;script&gt;
      fetch(&quot;https:&#x2F;&#x2F;micro.microcms.io&#x2F;api&#x2F;v1&#x2F;news&#x2F;0ik_dv015&quot;, {
        headers: {
          &quot;X-API-KEY&quot;: &quot;1598164e-2d58-488c-a4af-c51bd7d131a5&quot;
        }
      })
        .then(res =&gt; res.json())
        .then(json =&gt; {
          document.getElementById(&quot;title&quot;).innerHTML = json.title;
          document.getElementById(&quot;body&quot;).innerHTML = json.body;
        })
   &lt;&#x2F;script&gt;
  &lt;&#x2F;body&gt;
&lt;&#x2F;html&gt;</code></pre><p><br>Fetch APIを使ってmicroCMSからデータを取得し、そのデータを基にDOMを書き換えています。<br>（何らかのテンプレートエンジン&#x2F;フレームワークを用いることで、より効率的な実装も可能です）<br><br>このHTMLをブラウザから開くと次のように表示されます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/display-contents-01.png" alt></p>

コンテンツをブラウザで表示する

APIの呼び出し

<p>コンテンツを入力するフィールドのひとつとしてリッチエディタがあります。<br>ここではリッチエディタの操作方法を解説します。<br></p><h1 id="hdec08ed8b7">見出し、段落</h1><p><em>h1</em>〜<em>h5</em>、<em>p</em>タグに対応しています。<br><em>h1</em>〜<em>h5</em>にはテキストをハッシュ化した文字列が<em>id</em>として割り振られます。（つまり、テキストを変更しない限り<em>id</em>は固定となります）<br><br>割り振られた<em style="background-color:#ffffff">id</em>を用いて、フロントエンド側で目次を生成することが可能です。<br>詳細については下記の記事をご覧ください。</p>

<h1 id="heb169dcc37">文字サイズ</h1><p>小 &#x2F; 標準 &#x2F; 大 &#x2F; 最大 から選択可能です。<br>それぞれ、<em>font-size</em>が 0.75em &#x2F; 1em &#x2F; 1.5em &#x2F; 2.5em に相当します。<br></p><h1 id="h6548903b5d">太字</h1><p>テキストが<em>strong</em>タグで囲われます。<br></p><h1 id="hc296e45e2a">イタリック</h1><p>テキストが<em>em</em>タグで囲われます。<br></p><h1 id="hb64bcbf6df">アンダーライン</h1><p>テキストが<em>u</em>タグで囲われます。<br></p><h1 id="hdd1fc8dfe3">打ち消し線</h1><p>テキストが<em>s</em>タグで囲われます。<br></p><h1 id="h298b325e13">背景色</h1><p>テキストに背景色をつけます。<br></p><h1 id="h1371bbffe7">文字色</h1><p>テキストに文字色をつけます。<br></p><h1 id="h037aec0bed">テキスト寄せ</h1><p>左寄せ &#x2F; 中央寄せ &#x2F; 右寄せ &#x2F; <span style="color:#000000">均等割付 の指定ができます。</span><br></p><h1 id="hdf0456f9a2"><span style="color:#000000">引用</span></h1><p>テキストが<em>blockquote</em>タグで囲われます。<br></p><h1 id="hcf2b66e679">コード</h1><p>テキストが<em>pre</em>タグと<em>code</em>タグで囲われます。<br>ソースコードの入力に適しています。<br>シンタックスハイライトの実装を行い場合は下記の記事をご参考ください。</p>

<h1 id="had36204c49">番号付き箇条書き</h1><p>テキストが<em>ol</em>タグ、<em>li</em>タグで囲われます。<br></p><h1 id="h0d78c88097">箇条書き</h1><p>テキストが<em>ul</em>タグ、<em>li</em>タグで囲われます。<br></p><h1 id="he4ba96ecb5">リンク</h1><p>リンクを指定することができます。<br><em>https:&#x2F;&#x2F;</em>または<em>http:&#x2F;&#x2F;</em>始まりの場合は外部リンクとなり、<em>&#x2F;hoge</em>などのパス入力の場合は内部リンクとなります。<br></p><h1 id="h7b3c950f25">画像</h1><p>画像のアップロード、選択ができます。<br>画像のアップロードはメディア画面から行うことも可能です。<br>リッチエディタ内に入力された画像をクリックすることで、画像の width &#x2F; height &#x2F; alt とリンク先を指定することができます。<br></p><h1 id="haf38f3d7f3">外部サービス埋め込み</h1><p>外部サービスのURLを入力することで埋め込みをすることができます。<br>現在、対応しているサービスは以下になります。</p><ul><li>YouTube</li><li>Vimeo</li><li>Twitter</li><li>Instagram</li><li>Facebook</li><li>Speaker Deck</li><li>SlideShare</li></ul><p><br></p>

リッチエディタの操作方法

<p>microCMSではメンバーに対して柔軟に権限を設定することが可能です。<br>権限管理機能はStarterプランからご利用いただけます。<br></p><h1 id="hdcb010c82a">ロールによる権限設定</h1><p>「ロール」単位で細かく権限の設定ができ、メンバーに対して「ロール」を複数紐づけることができます。<br>ロール設定は <strong>サービス設定 &gt; ロール</strong> から行うことができます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/roles-01.png" alt><br><br>ロールの作成上限はプランごとに決まっております。<br>詳しくは<a href="https://microcms.io/pricing" target="_blank" rel="noopener noreferrer">料金プランページ</a>をご覧ください。<br><br>以下で各種権限の詳細を解説します。<br></p><h2 id="h21ed721515">メンバー設定</h2><h4 id="h853e877289">読み取り</h4><p>メンバー一覧、メンバー詳細画面にアクセスできるようになります。<br>左メニューにもサービスに所属しているメンバー数が表示されます。<br></p><h4 id="ha2cae467de">作成</h4><p>メンバーの作成ができるようになります。<br>※メンバー作成時にはロールの指定が必要なので、ロールの読み取り権限がない場合はメンバーの作成はできません。<br></p><h4 id="h962c7e628e">編集</h4><p>メンバーに紐づくロールを変更できるようになります。<br>※ロールの読み取り権限がない場合は、メンバーに紐づくロールの変更はできません。<br>※全メンバーの中で管理者が必ず1名以上必要なので、その条件を満たさない場合は変更できません。<br></p><h4 id="h419eb04cda">削除</h4><p>メンバーを削除できるようになります。<br>※全メンバーの中で管理者が必ず1名以上必要なので、その条件を満たさない場合は削除できません。<br></p><h2 id="haf2235e9af">ロール設定</h2><h4 id="h853e877289">読み取り</h4><p>ロール一覧、ロール詳細画面にアクセスできるようになります。<br></p><h4 id="ha2cae467de">作成</h4><p>ロールの作成ができるようになります。<br>ロールの作成上限はプランごとに決まっております。<br>詳しくは<a href="https://microcms.io/pricing" target="_blank" rel="noopener noreferrer">料金プランページ</a>をご覧ください。<br></p><h4 id="h962c7e628e">編集</h4><p>各ロールの権限内容を変更できるようになります。<br>※管理者ロールのみ固定ロールとなりますので、変更はできません。<br></p><h4 id="h419eb04cda">削除</h4><p>ロールを削除できるようになります。<br>※削除対象ロールにメンバーが紐づいている場合は削除できません。<br></p><h2 id="h86054d6ff8">お支払い設定</h2><h4 id="h853e877289">読み取り</h4><p>お支払い設定画面にアクセスできるようになります。<br>選択中のプラン、登録済みのクレジットカード情報、次回お支払い日などをご確認いただけます。<br></p><h4 id="h962c7e628e">編集</h4><p>プラン変更、クレジットカード変更が可能になります。<br></p><h2 id="h71a8f1fd78">APIキー設定</h2><h4 id="h853e877289">読み取り</h4><p>APIキー設定画面にアクセスできるようになります。<br></p><h4 id="h962c7e628e">編集</h4><p>こちらはロール設定から変更はできませんが、管理者ロールのみAPIキーの作成 &#x2F; 編集は可能となります。<br></p><h2 id="hf485b2462e">利用量確認</h2><h4 id="h853e877289">読み取り</h4><p>データ転送量確認画面、APIリクエスト数確認画面にアクセスできるようになります。<br></p><h2 id="h700b917b86">レビュー申請</h2><h4 id="h6761d7dd5b">読み取り（すべて）</h4><p>すべてのレビュー申請を閲覧することができます。<br></p><h4 id="h4a047e7f10">読み取り（自作成のみ）</h4><p>自分が申請したレビューのみ閲覧することができます。<br></p><h4 id="ha2cae467de">作成</h4><p>レビュー申請をすることができます。<br></p><h4 id="he839e5eebb">編集（すべて）</h4><p>レビューの承認（コンテンツ公開）、終了、再申請、コメント投稿、コメント削除（すべて）、レビュータイトル・説明の編集が可能です。<br></p><h4 id="h05686b91fd">編集（編集のみ）</h4><p>終了、再申請、コメント投稿、コメント削除（自分のコメントのみ）、レビュータイトル・説明の編集が可能です。<br></p><h4 id="hfdb20219e3">編集（なし）</h4><p>レビューに関して編集が一切できません。<br></p><h2 id="hb76587122e">メディア</h2><h4 id="h6761d7dd5b">読み取り（すべて）</h4><p>すべてのメディア（画像・ファイル）を閲覧することができます。<br></p><h4 id="h97543afbf1">読み取り（自アップロードのみ）</h4><p>自分でアップロードしたメディアのみ閲覧することができます。<br></p><h4 id="h5ccbebcd40">読み取り（なし）</h4><p>メディアを一切閲覧することができません。<br>リッチメディアフィールドからの画像選択や、画像 &#x2F; ファイルフィールドにおける画像選択もできなくなります。<br></p><h4 id="ha2cae467de">作成</h4><p>メディアのアップロードができるようになります。<br></p><h4 id="h962c7e628e">編集</h4><p>同名ファイルのアップロードによるファイルの上書きができるようになります。<br></p><h4 id="h419eb04cda">削除</h4><p>メディアの削除ができるようになります。<br></p><h2 id="h78df02fd38">API</h2><h4 id="h853e877289">読み取り</h4><p>左メニューのコンテンツ（API）の欄に該当APIが表示されるようになります。<br></p><h4 id="ha2cae467de">作成</h4><p>APIの作成ができるようになります。<br></p><h4 id="h962c7e628e">編集</h4><p>API設定全般とカスタムフィールドの作成 &#x2F; 編集 &#x2F; 削除が可能になります。<br></p><h4 id="h419eb04cda">削除</h4><p>APIの削除ができるようになります。<br></p><h2 id="h1480a3aa00">コンテンツ</h2><h4 id="h6761d7dd5b">読み取り（すべて）</h4><p>すべてのコンテンツを閲覧することができます。<br></p><h4 id="h4a047e7f10">読み取り（自作成のみ）</h4><p>自分で作成したコンテンツのみ閲覧することができます。<br>コンテンツ参照先にも同様の制限が適用されます。<br></p><h4 id="h5ccbebcd40">読み取り（なし）</h4><p>コンテンツを一切閲覧することができません。<br>コンテンツ参照先にも同様の制限が適用されます。<br></p><h4 id="h449c779f68">作成（公開まで）</h4><p>コンテンツを公開状態、または下書き状態で作成することができます。<br></p><h4 id="ha291a06bbb">作成（下書きまで）</h4><p>コンテンツを下書き状態で作成することができます。公開することはできません。<br></p><h4 id="hc40df1acf1">作成（なし）</h4><p>コンテンツを作成することができません。<br></p><h4 id="hb9bfcca0da">編集（公開まで）</h4><p>コンテンツを下書き =&gt; 公開、公開 =&gt; 下書き状態に変更することができます。<br>また、公開中コンテンツにおけるcontentIdの変更や、公開予約 &#x2F; 公開停止予約が可能です。<br></p><h4 id="h0b7c7cee93">編集（下書きまで）</h4><p>コンテンツを下書き保存することができます。<br>公開中のコンテンツを「公開中かつ下書き中」状態に変えることも可能です。<br>また、下書き中コンテンツにおけるcontentIdの変更ができます。<br></p><h4 id="hfdb20219e3">編集（なし）</h4><p>コンテンツの編集ができません。<br></p><h4 id="h419eb04cda">削除</h4><p>コンテンツを削除することができます。<br></p><h2 id="hd70d008d6e">開発者メニュー</h2><h4 id="h853e877289">読み取り</h4><p>開発者用の設定を非表示にすることができます。<br></p><ul><li>コンテンツ管理の上部メニューの「APIリファレンス」「API設定」「カスタムフィールド」が消える</li><li>APIプレビュー、GET&#x2F;POST表示が消える</li></ul><p><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/roles-02.png" alt><br></p><h1 id="hd0743dabb6">デフォルト権限と個別権限</h1><p><strong>デフォルト権限はサービス単位にかけられる権限</strong>で、全てのAPI &#x2F; コンテンツに対して制限が適用されます。<br>サービス全体で一括して権限設定を行いたい場合に有効です。<br><br>一方、<strong>個別権限はAPI単位にかけられる権限</strong>で、デフォルト権限を上書きすることができます。<br>個別権限では下記の項目を設定することができます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/roles-03.png" alt><br></p><h1 id="h61db3fef7b">権限の優先順位</h1><p>1メンバーに対して複数のロールを設定可能です。<br>メンバーに対するロールの紐付けはメンバー詳細画面から行うことができます。<br><br>設定した複数のロール同士で権限が異なる場合、より権限が広い方が優先されます。</p>

権限管理

<p>microCMSではインラインフレーム（iFrame）を用いて、外部データを管理画面内で選択できる機能があります。<br>（現在はBusinessプラン以降にて提供しております）<br></p><h1 id="h00b8af9eb7">仕様</h1><p>インラインフレームフィールドを用いて、iFrameとmicroCMS管理画面の間で<em>window.postMessage</em> APIを用いて値のやり取りを行います。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/iframe-field-03.png" alt><br></p><h2 id="h93adfe217e">microCMSからiFrameへの通信仕様</h2><h3 id="h9e44c21a42">①初期値の取得</h3><p>まず、インラインフレームフィールドが設定されているコンテンツ作成&#x2F;編集画面を開くと、microCMS管理画面からiFrameに対して下記のようにpostMessageを行います。</p><pre><code>{
　　id: &#x27;sfa3ff2c&#x27;,  &#x2F;&#x2F; 任意の識別子
  action: &quot;MICROCMS_GET_DEFAULT_DATA&quot;,
  message: value  &#x2F;&#x2F; 設定済みの値
}</code></pre><p><br>iFrame側はmessageイベントに対してEventListenerを設定しておくことで、上記のメッセージを受け取ることができます。<br><em>id</em>は送信時に使用するのでどこかに保持しておきましょう。<br><em>message</em>の値は初期値として利用します。（初回は<em>undefined</em>です）</p><pre><code>window.addEventListener(&#x27;message&#x27;, (e) =&gt; {
  if (
    e.isTrusted === true &amp;&amp;
    e.data.action === &#x27;MICROCMS_GET_DEFAULT_DATA&#x27;
  ) {
   &#x2F;&#x2F; idやmessageを保存する
    &#x2F;&#x2F; e.data.id: 識別子
    &#x2F;&#x2F; e.data.message: 設定済みの値
  }
});</code></pre><p><br></p><h2 id="hb330403397">iFrameからmicroCMSへの通信仕様</h2><h3 id="h7f543cc470">②データの送信</h3><p>逆に何らかのデータをiFrame側からmicroCMSの管理画面に対してPOSTしたい場合は下記のようにpostMessageを行います。</p><pre><code>window.parent.postMessage(
　　{
　　　　id: this.id,
　　　　action: &#x27;MICROCMS_POST_DATA&#x27;,
　　　　message: {
      id: &#x27;some-id&#x27;,
      title: &#x27;some-title&#x27;,
      description: &#x27;some-description&#x27;,
      imageUrl: &#x27;some-image-url&#x27;,
      updatedAt: &#x27;some-updated-at&#x27;,
      data: {    &#x2F;&#x2F; APIのレスポンスとなる部分
        id: &#x27;123&#x27;
      }
　　　　}
　　},
　　&#x27;https:&#x2F;&#x2F;your-service-id.microcms.io&#x27;
);</code></pre><p><br><em>id</em>には画面ロード時にmicroCMS側から受け取ったidを指定してください。<br><em>action</em>には<em>&#x27;MICROCMS_POST_DATA&#x27;</em>と指定してください。<br><em>message</em>にはメタ情報として次の項目があります。</p><ul><li>id（String）</li><li>title（String）</li><li>description（String）</li><li>imageUrl（String: URL形式）</li><li>updatedAt（Date）</li></ul><p><br>これらは全て任意項目であり、microCMSの管理画面内で管理しやすいように設定する値です。<br>設定しておくと、コンテンツ一覧画面等で表示されます。<br><br>また、APIレスポンス用のフィールドとして<em>data</em>があります。</p><ul><li>data（型不定）</li></ul><p><br><em>data</em>に指定した値が実際にコンテンツのGET APIからiFrameフィールド用の値として返されます。<br><br>セキュアな通信を行うために、postMessageの第二引数にはmicroCMS管理画面のURLを指定します。<br></p><h3 id="hddc40608fe">③スタイルの変更</h3><p>iFrameの高さは初期ロード時に決定してしまうため、iFrame内のUIが変化した際に見づらくなってしまう可能性があります。<br>そこで、iFrameから下記のようなpostMessageを行うことで、iFrame自体の<em>height</em>, <em>width</em>を変更することができます。</p><pre><code>window.parent.postMessage(
　　{
　　　　id: this.id,
　　　　action: &#x27;MICROCMS_UPDATE_STYLE&#x27;,
　　　　message: {
      height: 300,
      width: &#x27;100%&#x27;
　　　　}
　　},
　　&#x27;https:&#x2F;&#x2F;your-service-id.microcms.io&#x27;
);</code></pre><p><br></p><h2 id="h59d6ccf20c">APIからのレスポンス</h2><h3 id="h21574cda34">④レスポンスの取得</h3><p>次のようなAPIスキーマを例に挙げます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/iframe-field-04.png" alt><br><br>iFrameフィールドにdataとして下記の値をセットします。<br></p><pre><code>{
    data: {
        id: &#x27;123&#x27;
    }
}</code></pre><p><br>入力された値はコンテンツのGET APIから次のように取得することができます。<br></p><pre><code>{
    &quot;id&quot;: &quot;mir1wo77g&quot;,
    &quot;createdAt&quot;: &quot;2020-07-21T14:12:14.606Z&quot;,
    &quot;updatedAt&quot;: &quot;2020-07-21T14:12:14.606Z&quot;,
    &quot;publishedAt&quot;: &quot;2020-07-21T14:12:14.606Z&quot;,
    &quot;title&quot;: &quot;タイトルのテスト&quot;,
    &quot;iframe&quot;: {
        &quot;id&quot;: &quot;123&quot;
    }
}</code></pre><p><br></p><h1 id="h4c87115483">microCMS管理画面での設定方法</h1><p>API設定 &gt; APIスキーマの種類から「インラインフレーム」を選択します。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/iframe-field-01.png" alt><br><br>iFrameで読み込む先のURLを入力します。<br>localhostも指定可能です。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:f6a90bbf-db9f-4b4a-8bc8-93d66a77ea58/service/microcms-docs/media/iframe-field-02.png" alt><br><br>フィールドの設定は以上で完了です。<br>コンテンツの編集画面に遷移すると、先ほど指定したURLがiFrameによって表示されます。</p>

外部データ連携（iFrameフィールド）

<p>microCMSではAPIや画像・ファイルの使用量を「<strong>データ転送量</strong>」と表現します。<br>1ヶ月あたりのデータ転送量の上限はプラン毎に定められおり、上限を超えるとご請求が発生しますのでご注意ください。<br>各プランのデータ転送量は<a href="https://microcms.io/pricing/" target="_blank" rel="noopener noreferrer">料金ページ</a>に記載されていますのでご確認ください。<br></p><h1 id="hc2f9bd415b">データ転送量を確認する</h1><p>データ転送量は管理画面より確認ができます。<br>サービスの設定画面内のメニューを洗濯すると以下のようなグラフが表示されます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/data-amount.png" alt><br><br>データ転送量は直近3ヶ月間の一日毎の値と合計値を確認できます。<br>画面の更新頻度に保証はありませんが、概ね前日分までがこちらの画面に記載されます。<br></p><h1 id="h84e5c31f7f">データ転送量として加算される操作</h1><p>データ転送量として加算される操作には以下があげられます。</p><ul><li><a href="/docs/content-api/get-list-contents">コンテンツAPI</a>を使ったjsonデータの取得</li><li>microCMSにアップロードした画像やファイルの取得（<a href="/docs/image-api/introduction">画像API</a>を使った場合も含む）</li><li>管理画面での画像の表示</li></ul><p><br></p>

<p><br></p><h1 id="h10162b75c3">データ転送量を節約する</h1><p>多くのケースで、データ転送量の多くを占めるのは<strong>画像の取得</strong>です。<br>コンテンツAPIによる1回のjsonデータの取得は通常数KBのデータ転送量であるのに対し、画像の場合は一度の取得で数MBものデータ転送量となることがあります。<br><br>例えば1MBの画像を取得するページを1ヶ月に100万回アクセスする場合、【<strong>1MB × 100万回 = 100万MB ≒1TB】</strong>でデータ転送量は約1TBとなります。<br><br>これを節約するために利用できるのが<a href="/docs/image-api/introduction" target="_blank" rel="noopener noreferrer">画像API</a>です。<br><br>ここに1毎の画像を用意し、microCMSにアップロードしました。<br>この画像のサイズは先ほどの例とおなじく約1MBです。<br><a href="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg" target="_blank" rel="noopener noreferrer">https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg</a><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg" alt><br><br>それでは画像APIを使ってみます。<br>今回はサイズの縮小として横幅を500ピクセル（URLに ?w=500 を付加）にしてみます。<br><a href="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg?w=200" target="_blank" rel="noopener noreferrer">https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg?w=500</a><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/1mb_sample.jpg?w=500&h=375" alt><br><br>たったこれだけですが前者の画像サイズは約1MBなのに対し、後者の画像サイズは約25KBと<strong>1&#x2F;40</strong>程度のサイズとなりました。<br>この画像を100万回取得した場合のデータ転送量は<strong>【25KB × 100万回 ≒ 2.5GB】</strong>と桁違いに小さくなります。<br><br>無駄なデータ転送量をかけないよう画像APIをぜひともご活用ください。</p>

データ転送量の確認方法

<p>コンテンツの保存後、自動でいくつかの値が付与されます。<br>自動で付与された値は管理画面で確認や変更が可能なほか、コンテンツAPIでも取得が可能です。</p><h1 id="h6f21981a23">contentId：コンテンツのid</h1><p>作成したコンテンツのidです。<br>ランダムな英小文字、数字、記号で構成されます。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:11889c08-ec2f-4d7a-b37c-49c5982b2b47/service/microcms-docs/media/content-id-in-management-screen.png" alt><br><br>contentIdは管理画面上で編集が可能です。<br>コンテンツAPIではパスを示す部分ですので、スラッグとしての利用も可能です。</p><h1 id="h8414d43a03">createdAt：コンテンツの作成日時</h1><p>コンテンツを作成した日時です。<br>初回にコンテンツを作成した日時が含まれます。</p><h1 id="h745a230a8c">updatedAt：コンテンツの更新日時</h1><p>コンテンツを更新した日時です。<br>コンテンツの更新にあたる操作やイベントには以下が含まれます。</p><ul><li>管理画面上での「公開」ボタン押下</li><li>管理画面上での「下書きボタン」押下</li><li>管理画面上での「下書きの破棄」ボタン押下</li><li>管理画面上での「下書きに戻す」ボタン押下</li><li>公開予約・予約停止による公開状態の変化時</li></ul><h1 id="h22e9748a5b">publishedAt：コンテンツの公開日時</h1><p>コンテンツを公開した日時です。<br><br>現在のmicroCMSでは、コンテンツのステータスが以下の3つのうちのいずれかとなります。</p><ul><li>公開中</li><li>下書き中</li><li>公開中かつ下書き中</li></ul><p><br>このうち、<strong>「下書き中」から「公開中」に変更された日時</strong>が今回追加された公開日時となります。<br><br>公開日時は公開してある記事を一度下書きにした後、再度公開を行った場合にも値が変化します。<br>下記にいくつかのパターンと公開日時の状態を示します。<br><br></p><ol><li><strong>下書き中</strong>：公開日時は存在しない。</li><li><strong>下書き中→公開中</strong>：公開日時が付与される。</li><li><strong>下書き中→公開中→下書き中→公開中</strong>：2回目に公開したタイミングで公開日時が更新される。</li><li><strong>下書き中→公開中→公開中かつ下書き中→公開中</strong>：記事のリライトなどの想定。1回目の公開以降、下書き保存は追加されるものの常に公開状態。そのため2回目の公開時にも公開日時は更新されない。</li></ol><p><br></p>

コンテンツに自動付与される値

<p>microCMS管理画面を安心してご利用いただくために、下記ブラウザでの閲覧を推奨しております。<br>ブラウザのバージョンは、いずれも最新版を利用してください。<br></p><h1 id="h86670169d0">PC</h1><ul><li>Google Chrome</li><li>Microsoft Edge</li><li>Firefox</li><li>Safari</li></ul><p><br></p><h1 id="h642c42ee32">スマートフォン</h1><ul><li>Google Chrome</li><li>Safari</li></ul>