Building out spec model

this one will take a few tests, there is significant recursion and threading going on.

test_specs/burgershop.openapi.yaml

@@ -141,13 +141,8 @@ paths:
       summary: Search a burger by ID - returns the burger with that identifier
       description: Look up a tasty burger take it and enjoy it
       parameters:
-        - in: path
-          name: burgerId
-          schema:
-            type: string
-          example: big-mac
-          description: the name of the burger. use this to order your food
-          required: true
+        - $ref: '#/components/parameters/BurgerId'
+        - $ref: '#/components/parameters/BurgerHeader'
       responses:
         "200":
           description: A tasty burger for you to eat. Wide variety of products to choose from
@@ -311,6 +306,29 @@ paths:
               example:
                 message: "failed looking up all dressings, something went wrong."
 components:
+  parameters:
+    BurgerHeader:
+      in: header
+      name: burgerHeader
+      schema:
+        properties:
+          burgerTheme:
+            type: string
+            description: something about a theme?
+          burgerTime:
+            type: number
+            description: number of burgers ordered this year.
+      example: big-mac
+      description: the name of the burger. use this to order your food
+      required: true
+    BurgerId:
+      in: path
+      name: burgerId
+      schema:
+        type: string
+      example: big-mac
+      description: the name of the burger. use this to order your food
+      required: true
   schemas:
     Error:
       type: object