docs: fix id used in endpoint path in OAS (#2795)

* docs: fix id used in endpoint path in OAS

* docs: small fixes to OAS comments

* revert changes in core package

* undo changes in core files

docs/api/admin/paths/publishable-api-keys.yaml

@@ -96,7 +96,7 @@ get:
     - api_token: []
     - cookie_auth: []
   tags:
-    - PublishableApiKeys
+    - PublishableApiKey
   responses:
     '200':
       description: OK

docs/api/admin/paths/publishable-api-keys_{id}_sales-channels.yaml

@@ -3,22 +3,29 @@ get:
   summary: List PublishableApiKey's SalesChannels
   description: List PublishableApiKey's SalesChannels
   x-authenticated: true
+  parameters:
+    - in: path
+      name: id
+      required: true
+      description: The ID of the Publishable Api Key.
+      schema:
+        type: string
   x-codeSamples:
     - lang: JavaScript
       label: JS Client
       source:
         $ref: >-
-          ../code_samples/JavaScript/publishable-api-keys_:id_sales-channels/getundefined
+          ../code_samples/JavaScript/publishable-api-keys_{id}_sales-channels/getundefined
     - lang: Shell
       label: cURL
       source:
         $ref: >-
-          ../code_samples/Shell/publishable-api-keys_:id_sales-channels/getundefined
+          ../code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined
   security:
     - api_token: []
     - cookie_auth: []
   tags:
-    - PublishableApiKeySalesChannels
+    - PublishableApiKey
   responses:
     '200':
       description: OK

docs/api/admin/paths/publishable-api-keys_{id}_sales-channels_batch.yaml

@@ -43,7 +43,7 @@ post:
     - api_token: []
     - cookie_auth: []
   tags:
-    - Publishable Api Key
+    - PublishableApiKey
   responses:
     '200':
       description: OK
@@ -112,7 +112,7 @@ delete:
     - api_token: []
     - cookie_auth: []
   tags:
-    - Publishable Api Key
+    - PublishableApiKey
   responses:
     '200':
       description: OK