published チェックボックスを持つ blog データベースの例です。
名前は生成されたスキーマに合わせて置き換えてください。
生成されたクライアントを使う
notcms init はスキーマを作り、nc をexportします。Next.jsはサーバー側で .env.local を読み込むので、
サーバーコンポーネントやサーバー専用の関数からそのクライアントをimportします。
"use client" を指定したコンポーネントにはimportしないでください。
自分でクライアントを作る場合は new Client({ schema }) のように schema を渡します。
認証情報だけでは型付きのクエリを定義できません。
公開するページの一覧を取得する
非同期のサーバーコンポーネントから、次のような関数を呼びます。 相対importは、生成したスキーマの保存先に合わせて変更してください。post.title を表示し、/blog/${post.id} へリンクします。Notionで定義したプロパティは
post.properties に、ページのタイトルとIDはトップレベルにあります。
取得エラーをthrowすると、Next.jsのエラー境界でサービス障害を扱えます。
障害を、取得に成功した空の一覧として表示しないようにします。
個別ページを取得する
プロパティで検索すると、公開条件を適用しながら本文を取得できます。app/blog/[id]/page.tsx で params をawaitしてIDを取り出し、この関数を呼びます。
結果が null の場合にだけNext.jsの notFound() を呼んでください。サービスの障害はエラーとして扱います。
getFirst は同期済みの本文を読むため、Notionの変更は次の同期後に反映されます。
get(id) との違いは1ページの取得を参照してください。
Markdown本文は post.content にあります。post.properties.content ではありません。
コンテンツの信頼度に合ったMarkdownレンダラーで描画してください。
HTMLを許可する場合、信頼できないHTMLはページへ挿入する前にサニタイズします。
公開条件と更新方法を決める
予約公開、言語のフォールバック、一覧と個別ページそれぞれの確認には、 検証済みのコンテンツレシピを利用できます。 このガイドには、非同期のparams を使ったNext.jsルートの例があります。
再利用できるクエリと公開判定のコードは
examples/content-recipes
で管理し、SDKのテストで検証しています。
Notionの同期後は、アプリで設定したキャッシュも更新してください。
静的にビルドしたサイトでは、編集の反映や公開を取り消したページの削除に再ビルドが必要です。
アプリに合う方式を明示的に選んでください。SDKへのリクエスト自体は、Next.jsのキャッシュ無効化やデプロイを行いません。