Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/examples/Product/CategoryOrderHints.json

@@ -1,5 +1,4 @@
 {
-  "categoryOrderHints": {
-    "7bcd33e6-c1c7-4b96-8d70-9b9b18b19b70": "0.992"
-  }
+  "1d20faef-e8e1-44f4-b1b9-3a25b68fd266": "0.1234",
+  "ed9556d2-203f-4c80-840d-79305f341ba8": "0.5678"
 }

api-specs/api/examples/Product/ProductVariantChannelAvailabilityMap.json

@@ -1,9 +1,16 @@
 {
   "cd724bd4-52fa-4d6d-b4b0-bb1560d70475": {
+    "id": "f64af276-a1ad-4eea-a8bc-89c453742a40",
+    "version": 3,
     "isOnStock": true,
     "restockableInDays": 10,
-    "availableQuantity": 20,
-    "version": 1,
-    "id": "f64af276-a1ad-4eea-a8bc-89c453742a40"
+    "availableQuantity": 20
+  },
+  "f73fa437-e244-4d6f-8723-52b447427e0b": {
+    "id": "beaa0b68-562b-4866-a42b-e61baf1043d1",
+    "version": 5,
+    "isOnStock": true,
+    "restockableInDays": 5,
+    "availableQuantity": 12
   }
 }

api-specs/api/types/product/CategoryOrderHints.raml

@@ -6,13 +6,12 @@ type: object
   key: string
   value: string
 description: |-
-  JSON object where the key is a [Category](ctp:api:type:Category) `id` and the value is an order hint.
-  Allows controlling the order of Products and how they appear in Categories. Products with no order hint have an order score below `0`. Order hints are non-unique.
-  If a subset of Products have the same value for order hint in a specific category, the behavior is undetermined.
+  JSON object where the keys are [Category](ctp:api:type:Category) `id`, and the values are order hint values: strings representing a number between `0` and `1`, but not ending in `0`. Order hints allow controlling the order of Products and how they appear in Categories. Products without order hints have an order score below `0`. Order hints are not unique. If a subset of Products have the same value for order hint in a specific category, the behavior is undetermined.
 example: !include ../../examples/Product/CategoryOrderHints.json
 properties:
   #prettier-ignore
-  /[0-9].[0-9]*[1-9]/:
+  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/:
     type: string
     description: |-
-      A string representing a number between 0 and 1 that must start with `0.` and cannot end with `0`.
+      A string representing a number between `0` and `1`, but not ending in `0`.
+    pattern: ^0\.[0-9]*[1-9]$

api-specs/api/types/product/ProductVariantChannelAvailabilityMap.raml

@@ -6,8 +6,10 @@ type: object
   key: string
   value: ProductVariantChannelAvailability
 description: |
-  JSON object where the key is a supply [Channel](ctp:api:type:Channel) `id` and the value is the [ProductVariantChannelAvailability](ctp:api:type:ProductVariantChannelAvailability) of the [InventoryEntry](ctp:api:type:InventoryEntry).
+  JSON object where the keys are supply [Channel](/projects/channels) `id`, and the values are [ProductVariantChannelAvailability](/projects/products#productvariantchannelavailability).
 example: !include ../../examples/Product/ProductVariantChannelAvailabilityMap.json
 properties:
-  //:
+  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/:
     type: ProductVariantChannelAvailability
+    description: |
+      JSON object where the keys are supply [Channel](ctp:api:type:Channel) `id`, and the values are [ProductVariantChannelAvailability](ctp:api:type:ProductVariantChannelAvailability).

api-specs/api/types/product/SearchKeywords.raml

@@ -6,9 +6,10 @@ type: object
   key: Locale
   value: SearchKeyword[]
 description: |
-  Search keywords are JSON objects primarily used by [Product Suggestions](/projects/products-suggestions), but are also considered for a [full text search](/projects/product-projection-search#full-text-search).
-  The keys are of type [Locale](ctp:api:type:Locale), and the values are an array of [SearchKeyword](ctp:api:type:SearchKeyword).
+  Although search keywords are primarily used by [Product Suggestions](/projects/products-suggestions), they are also considered for a [full text search](/projects/products-search#full-text-search). The keys are of type [Locale](ctp:api:type:Locale), and the values are an array of [SearchKeyword](ctp:api:type:SearchKeyword).
 example: !include ../../examples/Product/SearchKeywords.json
 properties:
   /^[a-z]{2}(-[A-Z]{2})?$/:
     type: SearchKeyword[]
+    description: |
+      Key-value pair where the keys are of type [Locale](ctp:api:type:Locale) and the values are an array of [SearchKeyword](ctp:api:type:SearchKeyword).