openapi: 3.0.0
info: { title: Petstore, version: "1.0" }
servers: [{ url: https://api.petstore.example/v1 }]
paths:
  /pets:
    get:
      operationId: listPets
      parameters: [{ name: limit, in: query, schema: { type: integer, minimum: 10 } }]
      responses: { "200": { description: ok } }
    post:
      operationId: createPet
      requestBody:
        content:
          application/json:
            schema: { type: object, required: [name], properties: { name: {type: string}, tag: {type: string} } }
      responses: { "201": { description: created } }
  /pets/{petId}:
    get:
      operationId: getPet
      parameters: [{ name: petId, in: path, required: true, schema: {type: string} }]
      responses: { "200": {description: ok} }
