Blog

新しいコンテンツ管理システム（CMS）を既存のツールとサービスのエコシステムに統合することは難しいかもしれませんが、高品質のAPIを備えたヘッドレスCMSではそうではありません。ヘッドレスCMSAPIが将来の準備にどのように役立つかを学ぶために読んでください。

Content-as-a-ServiceソリューションをヘッドレスAPIファーストのアプローチで他の最高のマイクロサービスに接続するには、サービスが通信できるように、両端に高品質のAPIが必要であることは間違いありません。うまく統合します。

しかし、高品質のAPIは実際にはどういう意味ですか？あなたが考えることができる多くの異なる角度があります。テスト可能で、安全で、十分に文書化されており、確実なエラー報告が必要です。ヘッドレスCMSを既存のアプリのエコシステムに統合するとき、または新しいアプリやWebサイトを構築するときに、一般的な課題に直面できるようにするために必要なAPI機能を見てみましょう。

ヘッドレスCMSAPIの重要な機能

なぜこれらの機能を検討する必要がありますか？重要なAPI機能のないヘッドレスCMSを選択するとします。現在は必ずしも必要ではないかもしれませんが、将来はどうでしょうか。この課題にどのように取り組みますか？回避策がなく、プラットフォームを切り替える必要がある場合はどうなりますか？先を考えて時間やお金などを節約しましょう！

1）コンテンツ配信用のAPI

これは、すべてのヘッドレスCMSのAPIの最も重要な部分です。これにより、保存されているコンテンツを取得して、ウェブサイト、モバイルアプリ、IoTなどの複数のチャネルに配信できます。

このAPIには、考慮すべきいくつかの側面があります。

• おそらく最も重要なのは、 APIサービスのパフォーマンスと可用性です。幸いなことに、これは通常、CDNを使用するヘッドレスCMSによって解決されます。 Fastlyなど。分散データセンターと高度なコンテンツキャッシュメカニズムにより、どこにいてもコンテンツをすばやく利用できます。
• 他の人があなたのコンテンツを取得するのを防ぐために、ヘッドレスCMSは特定のAPIセキュリティ機能を提供します。たとえば、リクエストごとに必要なAPIキーがあり、アプリのコンテンツ認証の追加構成がある場合があります。
• もう1つの側面は、コンテンツの取得をはるかに簡単にするさまざまなSDKとクライアントライブラリの可用性です。通常、JavaScript、.NET、Java、PHPなどの最も一般的な言語がサポートされています。
• 一部の開発者にとっては、 GraphQLデータクエリと操作言語をサポートし、1回のリクエストで必要なものを正確に要求する力を与えることが重要な場合があります。
• 今日のマルチチャネルの世界では、小さな画面やデバイスに合わせてコンテンツ画像を調整できる必要があります。通常の動作方法は、APIを介したオンザフライでの画像変換です。これには、サイズ変更、トリミング、サムネイルの作成が含まれます。

KenticoCloudがコンテンツ配信を処理する方法の詳細をご覧ください。

2）コンテンツ管理のためのAPI

ヘッドレスCMSは、コンテンツエディターがコンテンツを作成および管理するための優れたツールを提供しますが、開発者は、コードからそれを実行する必要がある状況に確実に遭遇します。

• 通常、既存のコンテンツリポジトリからコンテンツをインポートする必要があります。たとえば、既存のCMSから新しいヘッドレスCMSに記事をインポートします。これは通常、コンテンツを元の形式（別のCMS、XML、CSV、またはテキストファイルのデータベース）からJSONなどのより一般的な形式に解析し、に送信するスクリプトまたはアプリケーションを作成することを意味します。コンテンツ管理APIを介したヘッドレスCMS。コンテンツアセットや、インポートされた他のコンテンツを参照するコンテンツなど、他のリンクされたコンテンツのインポートが非常に一般的であることは間違いありません。ヘッドレスCMSのコンテンツ管理APIもそれをサポートしていることを確認してください。
• 継続的な開発アプローチを活用している場合は、すべての環境が同期していることを確認する必要があります。作成、更新、または削除されたすべてのコンテンツを反映するだけでなく、コンテンツタイプ（たとえば、新しいコンテンツタイプ属性が追加された）およびコンテンツ分類法（たとえば、作成された新しいコンテンツカテゴリ）に対するすべての変更も反映する必要がある場合があります。ここで、高品質のコンテンツ管理APIが役立ちます。

KenticoCloudがコンテンツのインポートを処理する方法の詳細をご覧ください。管理APIを使用してコンテンツモデルと分類を管理できるようにする今後の機能の更新については、 Kenticoクラウド製品ロードマップを確認してください。

3）コンテンツ変更通知のAPI

ヘッドレスCMSとマイクロサービスの世界では、他のアプリケーションやサービスと通信できることが不可欠です。ヘッドレスCMSに関しては、通常、コンテンツが変更されたときに他のアプリケーションまたはサービスの1つに通知して、アプリケーションまたはサービスがそれに応じて応答できるようにする必要があります。

たとえば、 Algoliaなどのサービスとしての検索を使用して、オンライン記事の全文検索エクスペリエンスを提供している場合、新しい記事が取得されるたびに記事の検索インデックスを更新する必要があります。検索サービスがそのインデックスをヘッドレスCMSの外部に保存するため、公開されました。

ヘッドレスCMSの通知メカニズムは、通常、 Webhookによって保証されます。上記のように、Webhookは、ヘッドレスCMSプロジェクト内で何かが変更されたときにアプリケーションに通知するプログラム通知と考えてください。 Webhookには、変更の種類と影響を受けるコンテンツに関する構造化された情報が含まれています。

他のタイプのAPIと同様に、Webhookの柔軟性も重要です。コンテンツが公開されたときだけでなく、コンテンツがコンテンツ管理ワークフロー内の別のステップに移動されたときにも通知を受ける機能は非常に役立ちます。 Webhookを使用して、公開する前に翻訳の準備ができているコンテンツについて翻訳サービスに通知できます。

Webhookは次の目的にも使用できます。

• メールを送信するか、Slackチャネルにメッセージを投稿するか、Trello内でカードを移動して、チームに通知します。
• 新しく公開されたコンテンツアイテムをフィーチャーしたTwitterでのソーシャルメディア投稿のスケジュール。
• Zapier、IFTTT、またはその他のIntegration-platforms-as-a-Service（iPaaS）ソリューションとの統合。これにより、オンラインサービスとアプリケーションを統合し、それらの間のタスクを自動化できます。
• アプリのキャッシュを無効にして、ユーザーに最新のコンテンツが表示されるようにします。
• 新しい言語バリアントを作成して、公開されたコンテンツを翻訳します。

Kentico CloudWebhookのサポートの詳細をご覧ください。自動翻訳のサポートの向上の一環としてWebhookのサポートを拡張することを検討している機能の更新については、Kenticoクラウド製品ロードマップを確認してください。

4）システム拡張性のためのAPI

多くのコンテンツ編集者は、ヘッドレスCMSで作成しているコンテンツ内で既存の外部コンテンツを使用する必要があります。たとえば、記事にデジタル資産管理（DAM）システムの画像を使用する必要がある場合があります。あまり機能のないヘッドレスCMSでは、画像のURLをコピーして貼り付けることができますが、それはあまりユーザーフレンドリーではなく、保守が難しい場合があります。より良いオプションは、コンテンツ編集者がヘッドレスCMS内のDAMシステムから画像を直接検索して選択し、時間の経過とともに変化しない一意の識別子を介して画像への参照のみを保存できるようにすることです。

もう1つの例は、ヘッドレスCMSにアップロードされたアセットからキーワードやその他の情報を抽出することで自動タグ付けを提供するAIタグ付けサービスを統合することにより、外部分類法を活用することです。

これらの目的のために、ヘッドレスCMSは通常、特定のタイプのUI拡張フレームワークを提供し、外部システムと統合して、そのコンテンツをヘッドレスCMSのコンテンツと一緒に使用できるようにします。同時に、通常、開発者がヘッドレスCMS内のコンテンツオーサリングエクスペリエンスをコンテンツ編集者のニーズに合わせてカスタマイズするのに役立ちます。たとえば、YouTubeビデオセレクターや専用のMarkdownエディターを作成できます。

すべてを一緒に入れて

これで、次のような複雑な統合を構築できるようにするためのヘッドレスCMSAPIの重要な機能についてよりよく理解できたはずです。

1. コンテンツ配信
2. コンテンツ管理
3. コンテンツ変更通知
4. システムの拡張性

高品質のヘッドレスCMSAPIを検討するために考慮すべきいくつかの側面があると確信しているので、以下のコメントでそれらを共有することを躊躇しないでください。

ご入力をお待ちしております！