Order REST APIのv2とv2.1の違い

もしあなたのSitecore CDPのインスタンスが2.1データモデルを使用している場合は、Order REST APIのREST APIsバージョン2.1へのアップグレードをお勧めします。APIには以下が含まれます:

• 注文REST API
• 商品の注文REST API
• 注文連絡先REST API
• 消費者REST APIを注文
• オーダーデータ拡張REST API
• 注文品目データ延長REST API

バージョン2とバージョン2.1の主な違いの概要は以下の通りです。

v2

v2.1

URI経路

URIパスには /v2/が含まれています。

URIパスには /v2.1/が含まれています。

部分演算の終点

• 部分的な更新や部分的な削除は利用できません。

• 更新や削除はリソース全体に影響を与えます。

• 新しい PATCH エンドポイントでは リソースの一部を更新できます。例えば、注文項目のデータ拡張で特定のキーと値のペアを更新しても、他の項目には影響を与えません。

• 新しい DELETE エンドポイントは、注文データ拡張や注文項目データ拡張から 特定のキー-値ペアを削除 しても、他のものには影響を与えません。

注文項目データ拡張のエンドポイント

このREST APIのバージョンには、注文項目データ拡張のためのエンドポイントはありません。

注文品のデータ拡張は バッチAPIでのみ利用可能です。

新しいエンドポイントは 注文項目データの拡張を扱うことができます。

作成可能なデータ拡張付きの 注文項目の例 を参照してください。

データ拡張キー-値ペア

データ拡張を使う際は、リクエストボディに "key":"default" を手動で含める必要があります。

key属性は自動的に設定されます。

注文品の種類

順序項目の type は許容値のリストのいずれかでなければなりません。

注文項目の type は、以下を除く任意の値を取ることができます。

• "FLIGHT"

• "HOTEL"

• "MORTGAGE"

• "MORTGAGE_APPLICATION"

• "LOAN_APPLICATION"

• "PERSONAL_LOAN"

• "RAIL"

作成できる 注文アイテムの例 をご覧ください。