Managing API Documentation

openapi: 3.1.0
info:
  title: Orders API
  version: 2.0.0
servers:
  - url: https://api.example.com/v2
paths:
  /orders/{id}:
    get:
      summary: Get order
      parameters:
        - { name: id, in: path, required: true, schema: { type: string } }
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema: { $ref: "#/components/schemas/Order" }

paths:
  /orders:
    post:
      x-codeSamples:
        - lang: curl
          source: |
            curl -X POST https://api.example.com/orders \
              -H "Authorization: Bearer $TOKEN" \
              -d '{"sku":"abc","qty":1}'
        - lang: javascript
          source: |
            const r = await fetch("/orders", {
              method: "POST",
              headers: { Authorization: `Bearer ${token}` },
              body: JSON.stringify({ sku: "abc", qty: 1 })
            });