fix(openapi): Fix all OpenAPI linting errors and add stricter validation rules (#2194)

### Issue

- Relates #2182

### Description

- Enable `info-license: error`
  - Add Apache 2.0 license to `openapi.yaml`
- Enable `tag-description: error`
  - Add descriptions to `Storage` and `Webhooks` tags
- Enable `no-invalid-schema-examples: error`
  - Fix all examples in `schema/` dir
- Enable `no-invalid-media-type-examples: error`
  - Fix all examples in `paths/` dir
- Enable `operation-4xx-response: error`
  - Add error response components based on the common `ErrorResponse`
- A few more minor fixes
  - `finishedAt` type is nullable
  - reference to `CreateOrUpdateVersionRequest`
  - ...

### Tests

- CI passes

Author: vdusek

apify-api/openapi/components/responses/BadRequest.yaml

@@ -0,0 +1,9 @@
+description: Bad request - invalid input parameters or request body.
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/common/ErrorResponse.yaml
+    example:
+      error:
+        type: invalid-input
+        message: "Invalid input: The request body contains invalid data."

apify-api/openapi/components/responses/NotFound.yaml

@@ -0,0 +1,9 @@
+description: Not found - the requested resource does not exist.
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/common/ErrorResponse.yaml
+    example:
+      error:
+        type: record-not-found
+        message: The requested resource was not found.

apify-api/openapi/components/responses/Unauthorized.yaml

@@ -0,0 +1,9 @@
+description: Unauthorized - authentication required or invalid token.
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/common/ErrorResponse.yaml
+    example:
+      error:
+        type: token-not-valid
+        message: Authentication token is not valid.

apify-api/openapi/components/schemas/actor-builds/Build.yaml

@@ -94,7 +94,7 @@ example:
   buildNumber: 0.1.1
   actorDefinition:
     actorSpecification: 1
-    name: exmpla-actor
+    name: example-actor
     version: "1.0"
     buildTag: latest
     environmentVariables:
@@ -113,7 +113,7 @@ example:
     storages:
       dataset:
         type: object
-        $schema: "http://json-schema.org/draft-07/schema#"
+        $schema: http://json-schema.org/draft-07/schema#
         properties:
           id:
             type: string

apify-api/openapi/components/schemas/actor-builds/PostAbortBuildResponse.yaml

@@ -15,9 +15,11 @@ example:
     status: ABORTED
     meta:
       origin: WEB
+      userAgent: Mozilla/5.0 (iPad)
     stats:
       durationMillis: 1000
       runTimeSecs: 5.718
+      computeUnits: 0.012699444444444444
     options:
       useCache: false
       memoryMbytes: 1024
@@ -27,3 +29,4 @@ example:
     usageTotalUsd: 0.02
     usageUsd:
       ACTOR_COMPUTE_UNITS: 0.02
+    buildNumber: 0.1.1

apify-api/openapi/components/schemas/actor-runs/Run.yaml

@@ -38,7 +38,7 @@ properties:
     examples: ["2019-11-30T07:34:24.202Z"]
     description: Time when the Actor run started.
   finishedAt:
-    type: string
+    type: [string, "null"]
     format: date-time
     examples: ["2019-12-12T09:30:12.202Z"]
     description: Time when the Actor run finished.

apify-api/openapi/components/schemas/actors/ActorDefinition.yaml

@@ -11,7 +11,7 @@ properties:
     description: The name of the Actor.
   version:
     type: string
-    pattern: ^[0-9]+\\.[0-9]+$
+    pattern: ^[0-9]+\.[0-9]+$
     description: The version of the Actor, specified in the format [Number].[Number], e.g., 0.1, 1.0.
   buildTag:
     type: string

apify-api/openapi/components/schemas/actors/ExampleRunInput.yaml

@@ -6,8 +6,7 @@ type: object
 properties:
   body:
     type: string
-    example:
-      helloWorld: 123
+    example: '{ "helloWorld": 123 }'
   contentType:
     type: string
     examples: [application/json; charset=utf-8]

apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml

@@ -30,7 +30,7 @@ properties:
   versions:
     type: array
     items:
-      $ref: ./CreateOrUpdateEnvVarRequest.yaml
+      $ref: ./CreateOrUpdateVersionRequest.yaml
     description: ""
   pricingInfos:
     type: array

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

@@ -46,7 +46,7 @@ properties:
     type: string
     format: uri
     description: A public link to access keys of the key-value store directly.
-    examples: ["https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/keys?signature=abc123"]
+    examples: [https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/keys?signature=abc123]
   urlSigningSecretKey:
     type: [string, "null"]
     description: A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the key-value store.