Contentful

Contentfulは、コンテンツを管理し、APIを通じてWebサイトやアプリへ届けるコンテンツプラットフォームです。RESTやGraphQLのAPIを提供し、配信・プレビュー・管理などの用途を分けています。[1]

管理する情報の構造と、その情報を画面に表示する実装は別です。CMSで何を保存し、表示側が何を受け取るかを整理すると、製品の役割を理解できます。

コンテンツタイプは、フィールドなどをまとめてコンテンツの構造を定めるものです。その構造に沿って個々の内容を登録したものをEntryとして扱います。[2]

たとえば、記事を扱う際に見出しと本文の項目を定め、それぞれの記事の内容を登録する構成が考えられます。これはデータ構造の例であり、登録しただけで完成したページのレイアウトまで決まるという意味ではありません。

APIは、利用者向けの配信、公開前の確認、コンテンツの管理で役割が異なります。公式資料の説明を整理すると、次のようになります。[1]

Content Delivery APIは読み取り専用で、コンテンツをJSONデータとして配信します。[3]プレビュー用・管理用のAPIと認証の用途も分かれているため、表示に必要なデータと操作に合うAPIを選びます。[1]

表示側は、APIで受け取ったデータを使って画面を作ります。どの情報を、どのレイアウトで表示するかは、Webサイトやアプリ側で実装する範囲です。

公開前の確認には、Content Preview APIと、Webサイトやアプリのプレビュー用環境を組み合わせます。[1]未公開データを確認する経路と、利用者へ公開する経路を分けて設計します。

導入時は、管理する項目、APIの用途、表示側の担当、公開を確認する手順を対応させます。配信用APIを使うことだけで、サイト全体の制作や公開設計が完了するわけではありません。