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_{id}_sales-channels.yaml

@@ -0,0 +1,51 @@
+get:
+  operationId: GetPublishableApiKeySalesChannels
+  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
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: >-
+          ../code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined
+  security:
+    - api_token: []
+    - cookie_auth: []
+  tags:
+    - PublishableApiKey
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              sales_channels:
+                type: array
+                items:
+                  $ref: ../components/schemas/sales_channel.yaml
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml