Swagger中的API参数在用户浏览器中会自动排序。

在Swagger文档生成的JSON文件中加入以下代码，以防止API参数在用户浏览器中自动排序：

{
  "swagger": "2.0",
  "info": {
    "title": "My API",
    "version": "1.0.0"
  },
  "host": "myapi.com",
  "schemes": [
    "https"
  ],
  "paths": {
    "/path/to/api": {
      "get": {
        "summary": "Summary of the API",
        "description": "Description of the API",
        "parameters": [
          {
            "name": "param1",
            "type": "string",
            "in": "query",
            "description": "Description of param1"
          },
          {
            "name": "param2",
            "type": "string",
            "in": "query",
            "description": "Description of param2"
          }
        ],
        ...
      }
    }
  },
  "securityDefinitions": {
    ...
  },
  "tags": [
    ...
  ],
  "definitions": {
    ...
  },
  "x-tagGroups": [
    ...
  ],
  "x-servers": [
    ...
  ],
  "x-applications": [
    ...
  ],
  "x-traces": [
    ...
  ]
}

在parameters数组中添加x-order键值对以设定参数在Swagger UI中的显示顺序：

{
    "name": "param1",
    "type": "string",
    "in": "query",
    "description": "Description of param1",
    "x-order": 1
},
{
    "name": "param2",
    "type": "string",
    "in": "query",
    "description": "Description of param2",
    "x-order": 2
}

这样设置后，在Swagger UI中，参数将根据x-order键值的设定顺序显示，而不是随机排序。