feat: recommended for you

Author: shortcuts

specs/common/schemas/SearchParams.yml

@@ -136,11 +136,7 @@ baseSearchParamsWithoutQuery:
       x-categories:
         - Personalization
     userToken:
-      type: string
-      description: Associates a [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/) with the current search.
-      example: '123456'
-      x-categories:
-        - Personalization
+      $ref: '#/userToken'
     getRankingInfo:
       type: boolean
       description: Incidates whether the search response includes [detailed ranking information](https://www.algolia.com/doc/guides/building-search-ui/going-further/backend-search/in-depth/understanding-the-api-response/#ranking-information).
@@ -209,6 +205,13 @@ paramsAsString:
   type: string
   default: ''
 
+userToken:
+  type: string
+  description: Associates a [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/) with the current search.
+  example: '123456'
+  x-categories:
+    - Personalization
+
 query:
   type: string
   description: Text to search for in an index.

specs/recommend/common/schemas/RecommendationsRequest.yml

@@ -3,6 +3,7 @@ recommendationsRequest:
     - $ref: './TrendingItemsQuery.yml#/trendingItemsQuery'
     - $ref: './TrendingFacetsQuery.yml#/trendingFacetsQuery'
     - $ref: './RecommendationsQuery.yml#/recommendationsQuery'
+    - $ref: './RecommendedForYouQuery.yml#/recommendedForYouQuery'
 
 baseRecommendRequest:
   type: object

specs/recommend/common/schemas/RecommendedForYouQuery.yml

@@ -0,0 +1,35 @@
+recommendedForYouQuery:
+  allOf:
+    - $ref: './RecommendationsRequest.yml#/baseRecommendRequest'
+    - $ref: '#/baseRecommendedForYouQuery'
+
+recommendedForYouQueryParameters:
+  allOf:
+    - $ref: '../../../common/schemas/SearchParams.yml#/searchParamsObject'
+    - $ref: '#/baseRecommendedForYouQueryParameters'
+
+baseRecommendedForYouQueryParameters:
+  type: object
+  properties:
+    userToken:
+      $ref: '../../../common/schemas/SearchParams.yml#/userToken'
+  required:
+    - userToken
+
+baseRecommendedForYouQuery:
+  type: object
+  additionalProperties: false
+  properties:
+    model:
+      $ref: '#/recommendedForYouModel'
+    queryParameters:
+      $ref: '#/recommendedForYouQueryParameters'
+    fallbackParameters:
+      $ref: '#/recommendedForYouQueryParameters'
+  required:
+    - model
+
+recommendedForYouModel:
+  description: Recommended for you model.
+  type: string
+  enum: [recommended-for-you]