feat(analytics): move offset and limit documentation to analytics to add details about pagination limit

Author: febeck

specs/analytics/common/parameters.yml

@@ -19,6 +19,34 @@ OrderBy:
   schema:
     $ref: '#/orderBy'
 
+Offset:
+  in: query
+  name: offset
+  description: |
+    Position of the first item to return.
+
+    Combined with the `limit` parameter, only the first 1000 items can be retrieved.
+  required: false
+  schema:
+    type: integer
+    default: 0
+    minimum: 0
+    maximum: 1000
+
+Limit:
+  in: query
+  name: limit
+  description: |
+    Number of items to return.
+
+    Combined with the `offset` parameter, only the first 1000 items can be retrieved.
+
+  required: false
+  schema:
+    type: integer
+    default: 10
+    maximum: 1000
+
 # private
 orderBy:
   type: string