1. Search

HTTPの実装

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Search APIは、Sitecore Content HubベースのAPIに基づいています。次の段落では、これら2つの違いについて説明します。

メソッド

Search APIは、標準のHTTPメソッドのサブセット、つまりGET、HEAD、およびPOSTメソッドを使用してタスクを実行します。これは読み取り専用のAPIと考えられており、基本APIを介して行われると、他の方法では非常にリソースを消費する操作を検索およびフィルタリングするためのインターフェイスとして使用されます。

名前

種類

GET

リソースの現在の状態 (コンテンツを含む) を取得します。

リソースの現在の状態 (コンテンツを除く) を取得します。

POST

GETが行うことは何でも行いますが、パラメータはurl引数の代わりにリソースに渡されます。

ヘッダー

Search APIは基本APIと同じリクエストヘッダーを使用しますが、レスポンスヘッダーはすべて使用されるわけではなく、次のようにSearch APIはリソースの作成をサポートしていないため、「Location」ヘッダーを使用しません。

レスポンスコード

Search APIのレスポンス・コードのセットは、ベース・APIのレスポンス・コードのサブセットでもあります。

  • "200 OK"

  • "304 Not Modified"

  • "400 Bad Request"

  • "403 Forbidden"

  • "404 Not Found"

  • "500 Server Error"

リンクス

このSearch APIは、すべての場所がリンクを通じてアクセスおよび検出可能であるという基本APIの原則に従います。

ページング

ページングの動作はbase APIの動作と似ていますが、違いは、ユーザーがページ サイズ オプションのリストから目的のページ サイズを選択できる点にあります。

分別

基本APIとは異なり、検索は、結果として返されるアセットタイプに応じて、事前定義されたパラメーターで並べ替えることができます。

文化

Search APIは多文化です。

キャッシング

この動作は、基本APIの動作と一致しています (Hypermedia APIのドキュメントのcachingを参照してください)。

認証

認証は基本APIを介して行われます。

この記事を改善するための提案がある場合は、 お知らせください!