1. Search and Recommendation APIを使用した検索エクスペリエンスの作成

Search and Recommendation APIの呼び出し

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

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

Sitecore Searchは、Searchおよび推奨APIのHTTPSプロトコルをサポートしています。APIはJSON形式のリクエストを受け入れます。

API URLと方法

API URLは、Sitecore Search、Developer ResourcesセクションのAPI Accessタブで取得できます。

POSTメソッドを使用して、Search and Recommendation APIにリクエストを送信できます。

認証

Sitecore Search REST APIにアクセスするには 、認証が必要です 。

必須オブジェクト

APIにリクエストを送信する場合、応答を取得するには、次のオブジェクトを含める必要があります。

  • rfk.domainId - これをリクエストのヘッダーに追加して、リクエストを行うドメインを指定します。

  • widget.items.rfkd_id - このキーを追加して、呼び出すウィジェットのrfkidを指定します。

  • widget.items.entity - このキーを追加して、この要求に使用するエンティティを指定します。

  • context.locale - マルチロケールドメインがある場合は、このオブジェクトを追加して、結果に使用する国と言語を指定します。

推奨オブジェクト

APIにリクエストを送信する場合は、次のオブジェクトを追加することをお勧めします。

  • context.user.uuid - ページにアクセスした訪問者の匿名の一意の識別子。このオブジェクトを追加して、訪問者に関連する検索結果を提供できるようにSitecore Searchします。 uuidに合格しない場合、表示される検索結果は、その特定の訪問者に合わせて調整されません。 uuidの生成方法については、「 UUIDを使用したサイト訪問者の追跡」を参照してください。

サンプルリクエスト

以下は、キーフレーズのコンテンツを取得するためのSearchおよび推奨APIへのサンプルPOST request cloud computingです。

{
    "widget": {
        "items": [
            {
                "rfk_id": "rfkid_7",
                "entity": "content",
                "search": {
                    "content": {},
                    "query": {
                        "keyphrase": "cloud computing"
                    }
                }
            }
        ]
    },
    "context": {
        "locale": {
            "country": "us",
            "language": "en"
        }
    }
}
この記事を改善するための提案がある場合は、 お知らせください!