genko.meの基本

genko.meは、文章や画像を管理画面で編集し、APIを通してWebサイトやアプリへ届けるヘッドレスCMSです。Next.jsではSDKがコンテンツの取得とHTML表示を担当し、ページのデザインはサイト側のCSSで指定します。

編集する人は管理画面で原稿を作成・公開し、開発する人はAPIまたはSDKでその原稿を取得します。サイトのコードを毎回変更しなくても、記事やお知らせを更新できるようになります。

最初に読むページ

コンテンツが届くまで

1. ワークスペースを選ぶ。 個人用またはチーム用の作業場所です。
2. APIを作る。 ブログ、お知らせ、プロフィールなど、管理する内容ごとに分けます。
3. スキーマを決める。 タイトル、本文、画像などのフィールドを定義します。
4. コンテンツを保存・公開する。 スキーマに沿って原稿を入力します。
5. サイトから取得する。 サーバー側でAPIキーを使い、公開されたコンテンツをJSONとして取得します。

用語

管理画面に表示する「名前」と、コードで使う「ID」は別です。たとえば表示名を「記事タイトル」にしても、フィールドIDがtitleなら取得するときはpost.titleです。

管理画面と配信APIの違い

管理画面では、ログインしたアカウントの権限に応じてコンテンツを読み書きします。配信APIはAPIキーで認証する読み取り用の入口で、通常は公開条件を満たしたコンテンツだけを返します。

下書きはプレビューで確認します。配信APIキーを持っているだけで、すべての下書きを一覧取得できるわけではありません。

画像やファイルはURLで配信されます。コンテンツを非公開にする操作と、ファイルへのアクセスを止める操作は同じではありません。メディア管理も確認してください。