REST API について
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
REST API は、HTTP 上に構築されたハイパーメディア API です。Sitecore Content Hub のすべてのオブジェクトは、要求時点でのオブジェクトの状態を表すリソースとしてモデル化されています。標準の HTTP 要求と応答を使用してオブジェクトの状態の照会や操作が行われ、標準の HTTP ヘッダーを使用して要求と応答が補強されます。さらに、すべてのサービスで一貫したパフォーマンスを提供するために、バックエンド サービスはスロットリング メカニズムを適用します。
REST アーキテクチャ パターンは、システムの状態をリソースとしてモデル化します。各リソースは一意の URL で識別されます。HTTP 要求を実行することにより、リソースの表現を転送および操作できます。REST API が異なるのは、それがハイパーメディア API でもあるということです。実質的に、リソース間の移動にはハイパーリンクが使用され、特定のリソースへの URL がどのように構築されているかを知る必要はありません。実際、この REST API ドキュメントに記載されている (サービス エンドポイント以外の) URL は文書化のみを目的としたものであり、クライアントが直接使用することはありません。その代わりに、クライアントはナビゲーション モデルを採用し、リソース間を移動することで URL を探索する必要があります。
データはすべて JSON として送受信されます。
API へのアクセスは、HTTPS を介して次の形式で行われます。
https://{{www.marketingcontenthub.com}}/api/
スロットリングのガイドラインについては、ドキュメントの「ベスト プラクティス」セクションを参照してください。REST API はスロットリングを内部的に処理しないため、開発者はコードでスロットリングを処理する必要があります。ベスト プラクティスでは、どのような場合にスクリプトや Microsoft Azure 機能を使用するかについても説明します (特に、「統合ツールの選び方」を参照してください)。