use RecommendUpdatedAt

Author: raed667

specs/recommend/common/responses/RecommendUpdatedAt.yml

@@ -0,0 +1,5 @@
+description: OK
+content:
+  application/json:
+    schema:
+      $ref: './common.yml#/recommendUpdatedAtResponse'

specs/recommend/common/responses/common.yml

@@ -0,0 +1,26 @@
+taskID:
+  type: integer
+  format: int64
+  example: 1514562690001
+  description: |
+    Unique identifier of a task.
+
+    A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the [`task` operation](#tag/Indices/operation/getTask) and this `taskID`.
+
+updatedAt:
+  type: string
+  example: 2023-07-04T12:49:15Z
+  description: Date and time when the object was updated, in RFC 3339 format.
+
+recommendUpdatedAtResponse:
+  type: object
+  description: Response, taskID, and update timestamp.
+  additionalProperties: false
+  required:
+    - taskID
+    - updatedAt
+  properties:
+    taskID:
+      $ref: '#/taskID'
+    updatedAt:
+      $ref: '#/updatedAt'

specs/recommend/common/schemas/RecommendRule.yml

@@ -9,7 +9,7 @@ RecommendRule:
       description: Rule metadata.
       properties:
         lastUpdate:
-          $ref: '../../../common/responses/common.yml#/updatedAt'
+          $ref: '../responses/common.yml#/updatedAt'
     objectID:
       $ref: '../../../common/parameters.yml#/ruleID'
     condition:
@@ -28,7 +28,7 @@ RecommendRule:
       type: array
       description: Time periods when the rule is active.
       items:
-        $ref: '#/timeRange'
+        $ref: '../../../common/schemas/Rule.yml#/timeRange'
 
 Condition:
   type: object
@@ -123,17 +123,3 @@ AutoFacetFilter:
         Whether the filter is negative.
         If true, recommendations must not have the same value for the `facet` attribute.
         If false, recommendations must have the same value for the `facet` attribute.
-
-timeRange:
-  type: object
-  additionalProperties: false
-  properties:
-    from:
-      type: integer
-      description: When the rule should start to be active, in Unix epoch time.
-    until:
-      type: integer
-      description: When the rule should stop to be active, in Unix epoch time.
-  required:
-    - from
-    - until

specs/recommend/paths/batchRecommendRules.yml

@@ -35,6 +35,6 @@ post:
 
   responses:
     '200':
-      $ref: '../../common/responses/UpdatedAt.yml'
+      $ref: '../common/responses/RecommendUpdatedAt.yml'
     '400':
       $ref: '../../common/responses/BadRequest.yml'