From fa3fbbf0f66696f1a12600726ed6928670fcb14f Mon Sep 17 00:00:00 2001
From: Bryan <blindaa121@gmail.com>
Date: Thu, 30 Jan 2025 13:10:26 -0800
Subject: [PATCH 01/10] Add manual support for explode property

---
 .../src/theme/ApiExplorer/buildPostmanRequest.ts      | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index c40e5d9e3..743d291d2 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -28,6 +28,17 @@ function setQueryParams(postman: sdk.Request, queryParams: Param[]) {
       }
 
       if (Array.isArray(param.value)) {
+        // Manual support for handling exploded query params
+        if (param.explode) {
+          let queryStringArr = [];
+
+          for (let i = 0; i < param.value.length; i++) {
+            queryStringArr.push(`${param.name}=${param.value[i]}`);
+          }
+
+          return queryStringArr.join("&");
+        }
+
         return new sdk.QueryParam({
           key: param.name,
           value: param.value.join(","),

From d786ecf8ea900e8386bd87702993b4d803c84084 Mon Sep 17 00:00:00 2001
From: Bryan <blindaa121@gmail.com>
Date: Thu, 30 Jan 2025 13:13:14 -0800
Subject: [PATCH 02/10] Add prefilled state for array param examples

---
 .../ParamFormItems/ParamArrayFormItem.tsx     | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamArrayFormItem.tsx b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamArrayFormItem.tsx
index d28430f92..de7331724 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamArrayFormItem.tsx
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamArrayFormItem.tsx
@@ -22,7 +22,10 @@ export interface ParamProps {
 function ArrayItem({
   param,
   onChange,
-}: ParamProps & { onChange(value?: string): any }) {
+  initialValue,
+}: ParamProps & { onChange(value?: string): any; initialValue?: string }) {
+  const [value, setValue] = useState(initialValue || "");
+
   if (param.schema?.items?.type === "boolean") {
     return (
       <FormSelect
@@ -38,7 +41,9 @@ function ArrayItem({
   return (
     <FormTextInput
       placeholder={param.description || param.name}
+      value={value}
       onChange={(e: React.ChangeEvent<HTMLInputElement>) => {
+        setValue(e.target.value);
         onChange(e.target.value);
       }}
     />
@@ -76,9 +81,21 @@ export default function ParamArrayFormItem({ param }: ParamProps) {
         value: values.length > 0 ? values : undefined,
       })
     );
+
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [items]);
 
+  useEffect(() => {
+    if (param.schema?.example?.length > 0) {
+      const examplesWithIds = param.schema.example.map((item: any) => ({
+        id: nanoid(),
+        value: item.toString(),
+      }));
+
+      setItems(examplesWithIds);
+    }
+  }, [param.schema.example, param.schema.length]);
+
   function handleDeleteItem(itemToDelete: { id: string }) {
     return () => {
       const newItems = items.filter((i) => i.id !== itemToDelete.id);
@@ -112,6 +129,7 @@ export default function ParamArrayFormItem({ param }: ParamProps) {
                 <ArrayItem
                   param={param}
                   onChange={handleChangeItem(item, onChange)}
+                  initialValue={item.value}
                 />
                 <button
                   className="openapi-explorer__delete-btn"

From bfc72cc5b71b73dd934cd86e56ab35c51d00f1fc Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Wed, 5 Feb 2025 09:15:30 -0500
Subject: [PATCH 03/10] added some examples to help with testing

---
 demo/examples/tests/paramSerialization.yaml | 313 ++++++++++++++++++++
 1 file changed, 313 insertions(+)
 create mode 100644 demo/examples/tests/paramSerialization.yaml

diff --git a/demo/examples/tests/paramSerialization.yaml b/demo/examples/tests/paramSerialization.yaml
new file mode 100644
index 000000000..bd4e5812e
--- /dev/null
+++ b/demo/examples/tests/paramSerialization.yaml
@@ -0,0 +1,313 @@
+openapi: 3.0.0
+info:
+  title: Parameter Serialization Demo API
+  version: 1.0.0
+  description: An API to demonstrate various parameter serialization options in OpenAPI 3.0
+
+tags:
+  - name: params
+    description: Parameter Serialization Tests
+
+paths:
+  /users/{userId}:
+    get:
+      tags:
+        - params
+      summary: Get user by ID
+      description: |
+        Schema:
+        ```yaml
+        userId:
+          in: path
+          required: true
+          schema:
+            type: integer
+          style: simple
+          explode: false
+        ```
+        Example:
+        ```
+        {userId} = 123
+        Result: /users/123
+        ```
+      parameters:
+        - name: userId
+          in: path
+          required: true
+          schema:
+            type: integer
+          style: simple
+          explode: false
+      responses:
+        "200":
+          description: Successful response
+
+  /items/{itemId}:
+    get:
+      tags:
+        - params
+      summary: Get item by ID (label style)
+      description: |
+        Schema:
+        ```yaml
+        itemId:
+          in: path
+          required: true
+          schema:
+            type: array
+            items:
+              type: integer
+          style: label
+          explode: false
+        ```
+        Example:
+        ```
+        {itemId} = [1, 2, 3]
+        Result: /items/.1,2,3
+        ```
+      parameters:
+        - name: itemId
+          in: path
+          required: true
+          schema:
+            type: array
+            items:
+              type: integer
+          style: label
+          explode: false
+      responses:
+        "200":
+          description: Successful response
+
+  /products{productCode}:
+    get:
+      tags:
+        - params
+      summary: Get product by code (matrix style)
+      description: |
+        Schema:
+        ```yaml
+        productCode:
+          in: path
+          required: true
+          schema:
+            type: object
+            properties:
+              category:
+                type: string
+              id:
+                type: integer
+          style: matrix
+          explode: true
+        ```
+        Example:
+        ```
+        {productCode} = {"category": "electronics", "id": 123}
+        Result: /products;category=electronics;id=123
+        ```
+      parameters:
+        - name: productCode
+          in: path
+          required: true
+          schema:
+            type: object
+            properties:
+              category:
+                type: string
+              id:
+                type: integer
+          style: matrix
+          explode: true
+      responses:
+        "200":
+          description: Successful response
+
+  /search:
+    get:
+      tags:
+        - params
+      summary: Search with various query parameter styles
+      description: |
+        Schema:
+        ```yaml
+        q:
+          in: query
+          schema:
+            type: string
+        tags:
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: form
+          explode: true
+        filters:
+          in: query
+          schema:
+            type: object
+            properties:
+              minPrice:
+                type: number
+              maxPrice:
+                type: number
+          style: deepObject
+          explode: true
+        sort:
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: spaceDelimited
+          explode: false
+        fields:
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: pipeDelimited
+          explode: false
+        ```
+        Example:
+        ```
+        q = "openapi"
+        tags = ["api", "docs"]
+        filters = {"minPrice": 10, "maxPrice": 100}
+        sort = ["name", "price"]
+        fields = ["id", "name", "description"]
+        Result: /search?q=openapi&tags=api&tags=docs&filters[minPrice]=10&filters[maxPrice]=100&sort=name%20price&fields=id|name|description
+        ```
+      parameters:
+        - name: q
+          in: query
+          schema:
+            type: string
+        - name: tags
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: form
+          explode: true
+        - name: filters
+          in: query
+          schema:
+            type: object
+            properties:
+              minPrice:
+                type: number
+              maxPrice:
+                type: number
+          style: deepObject
+          explode: true
+        - name: sort
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: spaceDelimited
+          explode: false
+        - name: fields
+          in: query
+          schema:
+            type: array
+            items:
+              type: string
+          style: pipeDelimited
+          explode: false
+      responses:
+        "200":
+          description: Successful response
+
+  /documents/{docId}:
+    get:
+      tags:
+        - params
+      summary: Get document with header parameter
+      description: |
+        Schema:
+        ```yaml
+        docId:
+          in: path
+          required: true
+          schema:
+            type: string
+        X-API-Version:
+          in: header
+          schema:
+            type: array
+            items:
+              type: string
+          style: simple
+          explode: false
+        ```
+        Example:
+        ```
+        {docId} = "doc123"
+        X-API-Version: ["v1", "v2"]
+        Result URL: /documents/doc123
+        Header: X-API-Version: v1,v2
+        ```
+      parameters:
+        - name: docId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: X-API-Version
+          in: header
+          schema:
+            type: array
+            items:
+              type: string
+          style: simple
+          explode: false
+      responses:
+        "200":
+          description: Successful response
+
+  /preferences:
+    get:
+      tags:
+        - params
+      summary: Get user preferences with cookie parameter
+      description: |
+        Schema:
+        ```yaml
+        userSettings:
+          in: cookie
+          schema:
+            type: object
+            properties:
+              theme:
+                type: string
+              language:
+                type: string
+          style: form
+          explode: true
+        ```
+        Example:
+        ```
+        userSettings = {"theme": "dark", "language": "en"}
+        Result URL: /preferences
+        Cookie: theme=dark; language=en
+        ```
+      parameters:
+        - name: userSettings
+          in: cookie
+          schema:
+            type: object
+            properties:
+              theme:
+                type: string
+              language:
+                type: string
+          style: form
+          explode: true
+      responses:
+        "200":
+          description: Successful response

From ce2dd2131ee5a1f4f423d5851f9fedeea6a779cc Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 11:57:07 -0500
Subject: [PATCH 04/10] cleanup spec

---
 demo/examples/tests/paramSerialization.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/demo/examples/tests/paramSerialization.yaml b/demo/examples/tests/paramSerialization.yaml
index bd4e5812e..918af354d 100644
--- a/demo/examples/tests/paramSerialization.yaml
+++ b/demo/examples/tests/paramSerialization.yaml
@@ -63,7 +63,7 @@ paths:
         Example:
         ```
         {itemId} = [1, 2, 3]
-        Result: /items/.1,2,3
+        Result: /items/.1.2.3
         ```
       parameters:
         - name: itemId
@@ -79,7 +79,7 @@ paths:
         "200":
           description: Successful response
 
-  /products{productCode}:
+  /products/{productCode}:
     get:
       tags:
         - params

From 75a828135e26679d2f968650ccc70cc31235dbb3 Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 11:57:40 -0500
Subject: [PATCH 05/10] expand support for query params

---
 .../theme/ApiExplorer/buildPostmanRequest.ts  | 80 ++++++++++++++++---
 1 file changed, 69 insertions(+), 11 deletions(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index 743d291d2..61992b6dd 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -27,27 +27,84 @@ function setQueryParams(postman: sdk.Request, queryParams: Param[]) {
         return undefined;
       }
 
+      // Handle array values
       if (Array.isArray(param.value)) {
-        // Manual support for handling exploded query params
-        if (param.explode) {
-          let queryStringArr = [];
-
-          for (let i = 0; i < param.value.length; i++) {
-            queryStringArr.push(`${param.name}=${param.value[i]}`);
-          }
+        if (param.style === "spaceDelimited") {
+          return new sdk.QueryParam({
+            key: param.name,
+            value: param.value.join(" "),
+          });
+        } else if (param.style === "pipeDelimited") {
+          return new sdk.QueryParam({
+            key: param.name,
+            value: param.value.join("|"),
+          });
+        } else if (param.explode) {
+          return param.value.map(
+            (val) =>
+              new sdk.QueryParam({
+                key: param.name,
+                value: val,
+              })
+          );
+        } else {
+          return new sdk.QueryParam({
+            key: param.name,
+            value: param.value.join(","),
+          });
+        }
+      }
 
-          return queryStringArr.join("&");
+      const decodedValue = decodeURI(param.value);
+      const tryJson = () => {
+        try {
+          return JSON.parse(decodedValue);
+        } catch (e) {
+          return false;
         }
+      };
+
+      const jsonResult = tryJson();
+
+      // Handle object values
+      if (jsonResult && typeof jsonResult === "object") {
+        if (param.style === "deepObject") {
+          return Object.entries(jsonResult).map(
+            ([key, val]) =>
+              new sdk.QueryParam({
+                key: `${param.name}[${key}]`,
+                value: val,
+              })
+          );
+        } else if (param.explode) {
+          return Object.entries(jsonResult).map(
+            ([key, val]) =>
+              new sdk.QueryParam({
+                key: key,
+                value: val,
+              })
+          );
+        } else {
+          return new sdk.QueryParam({
+            key: param.name,
+            value: Object.entries(jsonResult)
+              .map(([key, val]) => `${key},${val}`)
+              .join(","),
+          });
+        }
+      }
 
+      // Handle boolean values
+      if (typeof decodedValue === "boolean") {
         return new sdk.QueryParam({
           key: param.name,
-          value: param.value.join(","),
+          value: decodedValue ? "true" : "false",
         });
       }
 
       // Parameter allows empty value: "/hello?extended"
       if (param.allowEmptyValue) {
-        if (param.value === "true") {
+        if (decodedValue === "true") {
           return new sdk.QueryParam({
             key: param.name,
             value: null,
@@ -61,7 +118,8 @@ function setQueryParams(postman: sdk.Request, queryParams: Param[]) {
         value: param.value,
       });
     })
-    .filter((item): item is sdk.QueryParam => item !== undefined);
+    .flat() // Flatten the array in case of nested arrays from map
+    .filter((item) => item !== undefined);
 
   if (qp.length > 0) {
     postman.addQueryParams(qp);

From 19da1af2805ee0f65c7e3fb3f99252c60ddc57d4 Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 12:37:20 -0500
Subject: [PATCH 06/10] expand path params coverage

---
 .../theme/ApiExplorer/buildPostmanRequest.ts  | 54 +++++++++++++++++--
 1 file changed, 51 insertions(+), 3 deletions(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index 61992b6dd..fc15292cf 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -126,13 +126,61 @@ function setQueryParams(postman: sdk.Request, queryParams: Param[]) {
   }
 }
 
-function setPathParams(postman: sdk.Request, queryParams: Param[]) {
-  const source = queryParams.map((param) => {
+function setPathParams(postman: sdk.Request, pathParams: Param[]) {
+  // Map through the path parameters
+  const source = pathParams.map((param) => {
+    if (!param.value) {
+      return undefined;
+    }
+
+    let serializedValue;
+
+    // Handle different styles
+    if (Array.isArray(param.value)) {
+      if (param.style === "label") {
+        serializedValue = `.${param.value.join(".")}`;
+      } else if (param.style === "matrix") {
+        serializedValue = `;${param.name}=${param.value.join(";")}`;
+      } else {
+        serializedValue = param.value.join(",");
+      }
+      return new sdk.Variable({
+        key: param.name,
+        value: serializedValue,
+      });
+    }
+
+    const decodedValue = decodeURI(param.value);
+    const tryJson = () => {
+      try {
+        return JSON.parse(decodedValue);
+      } catch (e) {
+        return false;
+      }
+    };
+
+    const jsonResult = tryJson();
+
+    if (typeof jsonResult === "object") {
+      if (param.style === "matrix") {
+        serializedValue = Object.entries(jsonResult)
+          .map(([key, val]) => `;${key}=${val}`)
+          .join("");
+      } else {
+        serializedValue = Object.entries(jsonResult)
+          .map(([key, val]) => `${key}=${val}`)
+          .join(",");
+      }
+    } else {
+      serializedValue = decodedValue || `:${param.name}`;
+    }
+
     return new sdk.Variable({
       key: param.name,
-      value: param.value || `:${param.name}`,
+      value: serializedValue,
     });
   });
+
   postman.url.variables.assimilate(source, false);
 }
 

From 22d8a9d64b56e4e8abad550454af1a027eec5e49 Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 12:52:33 -0500
Subject: [PATCH 07/10] expand coverage for cookie params

---
 .../theme/ApiExplorer/buildPostmanRequest.ts  | 52 +++++++++++++++----
 1 file changed, 43 insertions(+), 9 deletions(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index fc15292cf..fe950c093 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -187,18 +187,52 @@ function setPathParams(postman: sdk.Request, pathParams: Param[]) {
 function buildCookie(cookieParams: Param[]) {
   const cookies = cookieParams
     .map((param) => {
-      if (param.value && !Array.isArray(param.value)) {
-        return new sdk.Cookie({
-          // TODO: Is this right?
-          path: "",
-          domain: "",
-          key: param.name,
-          value: param.value,
-        });
+      if (param.value) {
+        const decodedValue = decodeURI(param.value as string);
+        const tryJson = () => {
+          try {
+            return JSON.parse(decodedValue);
+          } catch (e) {
+            return false;
+          }
+        };
+
+        const jsonResult = tryJson();
+        if (typeof jsonResult === "object") {
+          if (param.style === "form") {
+            // Handle form style
+            if (param.explode) {
+              // Serialize each key-value pair as a separate cookie
+              return Object.entries(jsonResult).map(
+                ([key, val]) =>
+                  new sdk.Cookie({
+                    key: key,
+                    value: val,
+                  })
+              );
+            } else {
+              // Serialize the object as a single cookie with key-value pairs joined by commas
+              return new sdk.Cookie({
+                key: param.name,
+                value: Object.entries(jsonResult)
+                  .map(([key, val]) => `${key},${val}`)
+                  .join(","),
+              });
+            }
+          }
+        } else {
+          // Handle scalar values
+          return new sdk.Cookie({
+            key: param.name,
+            value: param.value,
+          });
+        }
       }
       return undefined;
     })
-    .filter((item): item is sdk.Cookie => item !== undefined);
+    .flat() // Flatten the array in case of nested arrays from map
+    .filter((item) => item !== undefined);
+
   const list = new sdk.CookieList(null, cookies);
   return list.toString();
 }

From 538b1c0c43dc6adb7ac7a87495ccd142861098a3 Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 13:07:17 -0500
Subject: [PATCH 08/10] expand header params support

---
 .../theme/ApiExplorer/buildPostmanRequest.ts  | 52 ++++++++++++++++++-
 1 file changed, 50 insertions(+), 2 deletions(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index fe950c093..f63588f6b 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -246,15 +246,63 @@ function setHeaders(
   other: { key: string; value: string }[]
 ) {
   postman.headers.clear();
+
   if (contentType) {
     postman.addHeader({ key: "Content-Type", value: contentType });
   }
+
   if (accept) {
     postman.addHeader({ key: "Accept", value: accept });
   }
+
   headerParams.forEach((param) => {
-    if (param.value && !Array.isArray(param.value)) {
-      postman.addHeader({ key: param.name, value: param.value });
+    if (param.value) {
+      const decodedValue = decodeURI(param.value as string);
+      const tryJson = () => {
+        try {
+          return JSON.parse(decodedValue);
+        } catch (e) {
+          return false;
+        }
+      };
+
+      const jsonResult = tryJson();
+      if (Array.isArray(param.value)) {
+        if (param.style === "simple") {
+          if (param.explode) {
+            // Each item in the array is a separate header
+            param.value.forEach((val) => {
+              postman.addHeader({ key: param.name, value: val });
+            });
+          } else {
+            // Array values are joined by commas
+            postman.addHeader({
+              key: param.name,
+              value: param.value.join(","),
+            });
+          }
+        }
+      } else if (typeof jsonResult === "object") {
+        if (param.style === "simple") {
+          if (param.explode) {
+            // Each key-value pair in the object is a separate header
+            Object.entries(jsonResult).forEach(([key, val]) => {
+              postman.addHeader({ key, value: val });
+            });
+          } else {
+            // Object is serialized as a single header with key-value pairs joined by commas
+            postman.addHeader({
+              key: param.name,
+              value: Object.entries(jsonResult)
+                .map(([key, val]) => `${key},${val}`)
+                .join(","),
+            });
+          }
+        }
+      } else {
+        // Handle scalar values
+        postman.addHeader({ key: param.name, value: param.value });
+      }
     }
   });
 

From edfd1087dbe90b1711ad7f4cbecada6b77caf8bc Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 13:43:28 -0500
Subject: [PATCH 09/10] ensure proper serialization of headers

---
 .../src/theme/ApiExplorer/buildPostmanRequest.ts              | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
index f63588f6b..fe077a2f2 100644
--- a/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
+++ b/packages/docusaurus-theme-openapi-docs/src/theme/ApiExplorer/buildPostmanRequest.ts
@@ -271,7 +271,7 @@ function setHeaders(
         if (param.style === "simple") {
           if (param.explode) {
             // Each item in the array is a separate header
-            param.value.forEach((val) => {
+            jsonResult.forEach((val: any) => {
               postman.addHeader({ key: param.name, value: val });
             });
           } else {
@@ -287,7 +287,7 @@ function setHeaders(
           if (param.explode) {
             // Each key-value pair in the object is a separate header
             Object.entries(jsonResult).forEach(([key, val]) => {
-              postman.addHeader({ key, value: val });
+              postman.addHeader({ key: param.name, value: `${key}=${val}` });
             });
           } else {
             // Object is serialized as a single header with key-value pairs joined by commas

From 93f8794a347433d601e7b4e7bd6a670db367ffc6 Mon Sep 17 00:00:00 2001
From: Steven Serrata <sserrata@paloaltonetworks.com>
Date: Thu, 6 Feb 2025 13:45:02 -0500
Subject: [PATCH 10/10] enhance headers and cookies tests

---
 demo/examples/tests/paramSerialization.yaml | 84 +++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/demo/examples/tests/paramSerialization.yaml b/demo/examples/tests/paramSerialization.yaml
index 918af354d..cc6fe782c 100644
--- a/demo/examples/tests/paramSerialization.yaml
+++ b/demo/examples/tests/paramSerialization.yaml
@@ -311,3 +311,87 @@ paths:
       responses:
         "200":
           description: Successful response
+
+  /headers:
+    get:
+      tags:
+        - params
+      summary: Get with header parameters
+      description: |
+        Schema:
+        ```yaml
+        X-Custom-Header:
+          in: header
+          schema:
+            type: object
+            properties:
+              key1:
+                type: string
+              key2:
+                type: string
+          style: simple
+          explode: true
+        ```
+        Example:
+        ```
+        X-Custom-Header = {"key1": "value1", "key2": "value2"}
+        Result:
+        X-Custom-Header: key1=value1
+        X-Custom-Header: key2=value2
+        ```
+      parameters:
+        - name: X-Custom-Header
+          in: header
+          schema:
+            type: object
+            properties:
+              key1:
+                type: string
+              key2:
+                type: string
+          style: simple
+          explode: true
+      responses:
+        "200":
+          description: Successful response
+
+  /cookies:
+    get:
+      tags:
+        - params
+      summary: Get with cookie parameters
+      description: |
+        Schema:
+        ```yaml
+        userSettings:
+          in: cookie
+          schema:
+            type: object
+            properties:
+              theme:
+                type: string
+              language:
+                type: string
+          style: form
+          explode: false
+        ```
+        Example:
+        ```
+        userSettings = {"theme": "dark", "language": "en"}
+        Result: userSettings=theme,dark,language,en
+        ```
+      parameters:
+        - name: userSettings
+          in: cookie
+          schema:
+            type: object
+            properties:
+              theme:
+                type: string
+              language:
+                type: string
+          style: form
+          explode: false
+      responses:
+        "200":
+          description: Successful response