docs: add new signed URL fields to dataset & key-value store (#1767)

This PR updates updates storage responses:
- GET dataset has `itemsPublicUrl` and `urlSigningSecretKey`
- GET KV store has `keysPublicUrl` and `urlSigningSecretKey`
- Get KV store keys, item has `recordPublicUrl`

Author: danpoletaev

apify-api/openapi/components/schemas/datasets/Dataset.yaml

@@ -69,5 +69,13 @@ properties:
   consoleUrl:
     type: string
     example: 'https://console.apify.com/storage/datasets/27TmTznX9YPeAYhkC'
+  itemsPublicUrl:
+    type: string
+    description: "A public link to access the dataset items directly."
+    example: 'https://api.apify.com/v2/datasets/WkzbQMuFYuamGv3YF/items?signature=abc123'
+  urlSigningSecretKey:
+    type: string
+    description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the dataset."
+    nullable: true
   stats:
     $ref: ./DatasetStats.yaml

apify-api/openapi/components/schemas/key-value-stores/KeyValueStore.yaml

@@ -6,6 +6,7 @@ required:
   - modifiedAt
   - accessedAt
   - consoleUrl
+  - keysPublicUrl
 type: object
 properties:
   id:
@@ -42,5 +43,13 @@ properties:
   consoleUrl:
     type: string
     example: 'https://console.apify.com/storage/key-value-stores/27TmTznX9YPeAYhkC'  
+  keysPublicUrl:
+    type: string
+    description: "A public link to access keys of the key-value store directly."
+    example: 'https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/keys?signature=abc123'
+  urlSigningSecretKey:
+    type: string
+    description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the key-value store."
+    nullable: true
   stats:
     $ref: ./KeyValueStoreStats.yaml

apify-api/openapi/components/schemas/key-value-stores/ListOfKeysResponse.yaml

@@ -14,13 +14,18 @@ properties:
       required:
         - key
         - size
+        - recordPublicUrl
       properties:
         key:
           type: string
           example: second-key
         size:
           type: number
           example: 36
+        recordPublicUrl:
+          type: string
+          description: "A public link to access this record directly."
+          example: 'https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/records/some-key?signature=abc123'
     description: ''
   count:
     type: number