refactor: rename OpenAPI endpoints (#1434)

Recently, we created new endpoints:

`/v2/acts/:actorId/builds/:buildId/openapi-specification`
`/v2/actor-builds/:buildId/openapi-specification`
Than we've received a feedback to rename endpoints to `/openapi.json`.

**This PR renames OpenAPI endpoints from `*/openapi-specification` to
`*/openapi.json`*

More context
[here](https://apify.slack.com/archives/C01VBUV81UZ/p1737975106009729)

Author: danpoletaev

apify-api/openapi/components/tags.yaml

@@ -255,15 +255,15 @@
     ```
 
     In order to save new items to the dataset, send HTTP POST request with JSON payload to the same URL.
-- name: Actors/Get OpenAPI specification
-  x-displayName: Get OpenAPI specification
+- name: Actors/Get OpenAPI definition
+  x-displayName: Get OpenAPI definition
   x-parent-tag-name: Actors
   x-trait: 'true'
   description: |
-    Get the OpenAPI specification for Actor builds. Two similar endpoints are available:
+    Get the OpenAPI definition for Actor builds. Two similar endpoints are available:
 
-    - [First endpoint](/api/v2/act-openapi-specification-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
-    - [Second endpoint](/api/v2/actor-build-openapi-specification-get): Requires only `buildId`.
+    - [First endpoint](/api/v2/act-openapi-json-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
+    - [Second endpoint](/api/v2/actor-build-openapi-json-get): Requires only `buildId`.
 - name: Actor tasks
   x-displayName: Actor tasks
   x-legacy-doc-urls:
@@ -561,15 +561,15 @@
   - '#tag/Actor-buildsBuild-log'
   x-trait: 'true'
   description: Check out [Logs](#/reference/logs) for full reference.
-- name: Actor builds/Get OpenAPI specification
-  x-displayName: Get OpenAPI specification
+- name: Actor builds/Get OpenAPI definition
+  x-displayName: Get OpenAPI definition
   x-parent-tag-name: Actor builds
   x-trait: 'true'
   description: |
-    Get the OpenAPI specification for Actor builds. Two similar endpoints are available:
+    Get the OpenAPI definition for Actor builds. Two similar endpoints are available:
 
-    - [First endpoint](/api/v2/act-openapi-specification-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
-    - [Second endpoint](/api/v2/actor-build-openapi-specification-get): Requires only `buildId`.
+    - [First endpoint](/api/v2/act-openapi-json-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
+    - [Second endpoint](/api/v2/actor-build-openapi-json-get): Requires only `buildId`.
 - name: Key-value stores
   x-displayName: Key-value stores
   x-legacy-doc-urls:

apify-api/openapi/components/x-tag-groups.yaml

@@ -20,7 +20,7 @@
   - Actors/Metamorph run
   - Actors/Resurrect run
   - Actors/Last run object and its storages
-  - Actors/Get OpenAPI specification
+  - Actors/Get OpenAPI definition
 - name: Actor tasks
   tags:
   - Actor tasks
@@ -52,7 +52,7 @@
   - Actor builds/Delete build
   - Actor builds/Abort build
   - Actor builds/Build log
-  - Actor builds/Get OpenAPI specification
+  - Actor builds/Get OpenAPI definition
 - name: Key-value stores
   tags:
   - Key-value stores

apify-api/openapi/openapi.yaml

@@ -505,8 +505,8 @@ paths:
     $ref: 'paths/actors/acts@{actorId}@[email protected]'
   '/v2/acts/{actorId}/builds/{buildId}/abort':
     $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@abort.yaml'
-  '/v2/acts/{actorId}/builds/{buildId}/openapi-specification':
-    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@openapi-specification.yaml'
+  '/v2/acts/{actorId}/builds/{buildId}/openapi.json':
+    $ref: 'paths/actors/acts@{actorId}@builds@{buildId}@openapi.json.yaml'
   '/v2/acts/{actorId}/runs':
     $ref: 'paths/actors/acts@{actorId}@runs.yaml'
   '/v2/acts/{actorId}/run-sync':
@@ -559,8 +559,8 @@ paths:
     $ref: 'paths/actor-builds/actor-builds@{buildId}@abort.yaml'
   '/v2/actor-builds/{buildId}/log':
     $ref: 'paths/actor-builds/actor-builds@{buildId}@log.yaml'
-  '/v2/actor-builds/{buildId}/openapi-specification':
-    $ref: 'paths/actor-builds/actor-builds@{buildId}@openapi-specification.yaml'
+  '/v2/actor-builds/{buildId}/openapi.json':
+    $ref: 'paths/actor-builds/actor-builds@{buildId}@openapi.json.yaml'
   /v2/key-value-stores:
     $ref: paths/key-value-stores/key-value-stores.yaml
   '/v2/key-value-stores/{storeId}':

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

@@ -1,13 +1,13 @@
 get:
   tags:
-    - Actor builds/Get OpenAPI specification
-  summary: Get OpenAPI specification
+    - Actor builds/Get OpenAPI definition
+  summary: Get OpenAPI definition
   description: |
-    Get the OpenAPI specification for a specific Actor build.
+    Get the OpenAPI definition for a specific Actor build.
     Authentication is based on the build's unique ID. No authentication token is required.
     
-    **Note**: You can also use the `/api/v2/act-openapi-specification-get` endpoint to get the OpenAPI specification for a build.
-  operationId: actorBuild_openapiSpecification_get
+    **Note**: You can also use the `/api/v2/act-openapi-json-get` endpoint to get the OpenAPI definition for a build.
+  operationId: actorBuild_openapi_json_get
   security:
     - apiKeyActorBuilds: []
     - httpBearerActorBuilds: []

apify-api/openapi/paths/actors/acts@{actorId}@builds@{buildId}@openapi-specification.yaml apify-api/openapi/paths/actors/acts@{actorId}@builds@{buildId}@openapi.json.yaml

@@ -1,15 +1,15 @@
 get:
   tags:
-    - Actors/Get OpenAPI specification
-  summary: Get OpenAPI specification
+    - Actors/Get OpenAPI definition
+  summary: Get OpenAPI definition
   description: |
-    Get the OpenAPI specification for a specific Actor build.
+    Get the OpenAPI definition for a specific Actor build.
 
     To fetch the default Actor build, simply pass `default` as the `buildId`.
     Authentication is based on the build's unique ID. No authentication token is required.
     
-    **Note**: You can also use the `/api/v2/actor-build-openapi-specification-get` endpoint to get the OpenAPI specification for a build.
-  operationId: act_openapiSpecification_get
+    **Note**: You can also use the `/api/v2/actor-build-openapi-json-get` endpoint to get the OpenAPI definition for a build.
+  operationId: act_openapi_json_get
   security:
     - apiKeyActorBuilds: []
     - httpBearerActorBuilds: []