Merge branch 'master' into integration-playbook

Author: TC-MO

.github/CODEOWNERS

@@ -8,4 +8,4 @@
 /sources/academy/ @honzajavorek
 
 # OpenAPI spec
-/apify-api/ @netmilk @janbuchar @fnesveda
+/apify-api/ @janbuchar @fnesveda

apify-api/openapi/openapi.yaml

@@ -581,6 +581,8 @@ paths:
     $ref: 'paths/request-queues/request-queues@{queueId}.yaml'
   '/v2/request-queues/{queueId}/requests/batch':
     $ref: 'paths/request-queues/request-queues@{queueId}@requests@batch.yaml'
+  '/v2/request-queues/{queueId}/requests/unlock':
+    $ref: 'paths/request-queues/request-queues@{queueId}@requests@unlock.yaml'
   '/v2/request-queues/{queueId}/requests':
     $ref: 'paths/request-queues/request-queues@{queueId}@requests.yaml'
   '/v2/request-queues/{queueId}/requests/{requestId}':

apify-api/openapi/paths/actor-builds/actor-builds@{buildId}@openapi.json.yaml

@@ -37,3 +37,9 @@ get:
         application/json:
           schema:
             $ref: '../../components/schemas/actor-builds/GetOpenApiResponse.yaml'
+  x-js-parent: BuildClient
+  x-js-name: getOpenApiDefinition
+  x-js-doc-url: https://docs.apify.com/api/client/js/reference/class/BuildClient#getOpenApiDefinition
+  x-py-parent: BuildClient
+  x-py-name: get_open_api_definition
+  x-py-doc-url: https://docs.apify.com/api/client/python/reference/class/BuildClient#get_open_api_definition

apify-api/openapi/paths/actor-runs/actor-runs@{runId}@resurrect.yaml

@@ -38,6 +38,22 @@ post:
       schema:
         type: number
       example: 256
+    - name: maxItems
+      in: query
+      required: false
+      schema:
+        type: number
+      example: 1000
+      description: |
+        Optional number of items that the run should return. Used for pay-per-result Actors. The value can only be increased beyond the value specified when the Actor run was started.
+    - name: maxTotalChargeUsd
+      in: query
+      required: false
+      schema:
+        type: number
+      example: 10
+      description: |
+        Optional maximum cost of the run, in USD. Used for pay-per-event Actors. The value can only be increased beyond the value specified when the Actor run was started.
   responses:
     '200':
       description: ''

apify-api/openapi/paths/actors/acts@{actorId}@builds@default.yaml

@@ -74,3 +74,9 @@ get:
               inputSchema: '{\n  \"title\": \"Schema for ... }'
               readme: '# Magic Actor\nThis Actor is magic.'
               buildNumber: 0.1.1
+  x-js-parent: ActorClient
+  x-js-name: defaultBuild
+  x-js-doc-url: https://docs.apify.com/api/client/js/reference/class/ActorClient#defaultBuild
+  x-py-parent: ActorClient
+  x-py-name: default_build
+  x-py-doc-url: https://docs.apify.com/api/client/python/reference/class/ActorClient#default_build

apify-api/openapi/paths/key-value-stores/key-value-stores@{storeId}@keys.yaml

@@ -38,6 +38,19 @@ get:
         type: number
         format: double
         example: 100
+    - name: collection
+      in: query
+      description: Limit the results to keys that belong to a specific collection from the key-value store schema.
+        The key-value store need to have a schema defined for this parameter to work.
+      schema:
+        type: string
+        example: postImages
+    - name: prefix
+      in: query
+      description: Limit the results to keys that start with a specific prefix.
+      schema:
+        type: string
+        example: post-images-
   responses:
     '200':
       description: ''

apify-api/openapi/paths/request-queues/request-queues@{queueId}@requests@unlock.yaml

@@ -0,0 +1,58 @@
+post:
+  tags:
+    - Storage/Request queues/Requests locks
+  summary: Unlock requests
+  description: |
+    Unlocks requests in the queue that are currently locked by the client.
+
+    * If the client is within an Actor run, it unlocks all requests locked by that specific run plus all requests locked by the same clientKey.
+    * If the client is outside of an Actor run, it unlocks all requests locked using the same clientKey.
+  operationId: requestQueue_requests_unlock_post
+  parameters:
+    - name: queueId
+      in: path
+      description: Queue ID or `username~queue-name`.
+      required: true
+      style: simple
+      schema:
+        type: string
+        example: WkzbQMuFYuamGv3YF
+    - name: clientKey
+      in: query
+      description: |
+        A unique identifier of the client accessing the request queue. It must
+        be a string between 1 and 32 characters long
+      style: form
+      explode: true
+      schema:
+        type: string
+        example: client-abc
+  responses:
+    '200':
+      description: 'Number of requests that were unlocked'
+      content:
+        application/json:
+          schema:
+            type: object
+            required:
+              - data
+            properties:
+              data:
+                type: object
+                required:
+                  - unlockedCount
+                properties:
+                  unlockedCount:
+                    type: integer
+                    description: 'Number of requests that were successfully unlocked'
+          example:
+            data:
+              unlockedCount: 10
+
+  deprecated: false
+  x-js-parent: RequestQueueClient
+  x-js-name: unlockRequests
+  x-js-doc-url: https://docs.apify.com/api/client/js/reference/class/RequestQueueClient#unlockRequests
+  x-py-parent: RequestQueueClientAsync
+  x-py-name: unlock_requests
+  x-py-doc-url: https://docs.apify.com/api/client/python/reference/class/RequestQueueClientAsync#unlock_requests

nginx.conf

@@ -446,18 +446,45 @@ server {
 
 server {
     listen 0.0.0.0:8080;
-
+    resolver 172.20.0.10;
     server_name ~^(?<subdomain>[^.]+)\.preview\.docs\.apify\.com$;
 
+    # add trailing slashes to the root of GH pages docs
+    rewrite ^/api/client/js$ /api/client/js/ redirect;
+    rewrite ^/api/client/python$ /api/client/python/ redirect;
+    rewrite ^/sdk/js$ /sdk/js/ redirect;
+    rewrite ^/sdk/python$ /sdk/python/ redirect;
+    rewrite ^/cli$ /cli/ redirect;
+
+    location ~ ^/api/client/js/(.*)$ {
+        proxy_pass https://apify.github.io/apify-client-js/$1;
+    }
+    location ~ ^/api/client/python/(.*)$ {
+        proxy_pass https://apify.github.io/apify-client-python/$1;
+    }
+    location ~ ^/sdk/js/(.*)$ {
+        proxy_pass https://apify.github.io/apify-sdk-js/$1;
+    }
+    location ~ ^/sdk/python/(.*)$ {
+        proxy_pass https://apify.github.io/apify-sdk-python/$1;
+    }
+    location ~ ^/cli/(.*)$ {
+        proxy_pass https://apify.github.io/apify-cli/$1;
+    }
+
+    location = / {
+        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/index.html;
+    }
     location ~ ^/(.*)/$ {
         proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1/index.html;
     }
-
-    location ~ ^/(.*[^./])$ {
+    location ~ ^/([^.]+)$ {
         proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1.html;
     }
-
+    location ~ ^/(.*)$ {
+        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1;
+    }
     location / {
-        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/;
+        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain$uri;
     }
-}
+}