标签: swagger

我非常喜欢大量记录Restful API,特别是"试试看!" 按钮,但swagger-ui界面看起来不是很酷.

而且我无法相信这些神奇的开源工具没有模板(或者我找不到任何模板)？

我不希望它是免费的..像http://getbootstrap.com/有很多网站购买主题(如https://wrapbootstrap.com/),为什么我找不到任何swagger主题的网站？

lockdown-run.js：17 锁定失败：TypeError：在内在函数.Object.groupBy 预期布尔值不起作用

lockdown-more.js：99 保护内在函数失败：ReferenceError：harden 未定义（匿名）@lockdown-more.js：99

我试图解决这个问题但没有得到任何答案。

我正在开发REST API.在开发过程中我使用postman(chrome扩展)来使用和记录我的API.精彩的工具,我有大部分的端点.但是,当我们接近发布时,我想以夸张的方式记录这个API,我该怎么做？有没有办法可以根据邮递员出口产生招摇？

我在API中有一些端点 - /user/login, /products.

在扬鞭UI我张贴email,并password到/user/login和我收到的响应token串.

然后,我可以从响应中复制令牌,并希望将其用作Authorization对所有URL的请求中的标头值(如果它存在),并/products作为示例.

我应该在Swagger UI页面上的某处手动创建文本输入,然后将令牌放在那里并以某种方式注入请求或是否有工具以更好的方式管理它？

有没有为swagger 2.0创建静态文档的方法？也许就像在editor.swagger.io上的'预览'.

我需要获取静态html文件,以便将它们包含在一些静态文档中.

到目前为止,我还没有办法做到这一点.我看到有swagger-codegens static-docs,但这只适用于swagger <= 1.2.

我正试图在我的本地计算机上my.json用swagger-ui打开我自己生成的swagger规范文件.

所以我下载了最新的标签v2.1.8-M1并解压缩了.然后我进入子文件夹dist并将文件复制my.json到其中.现在我打开了index.html,想要探索my.json.这里问题就出现了:

如果我输入本地路径,它将始终以包含该路径的当前URL为前缀index.html.因此我无法打开我的文件.我没有成功地尝试了以下所有组合:

• my.json 导致 file:///D:/swagger-ui/dist/index.html/my.json
• file:///D:/swagger-ui/dist/my.json 导致 file:///D:/swagger-ui/dist/index.html/file:///D:/swagger-ui/dist/my.json

我在Swagger文件中有一个API参考.我想创建一个非常简单的模拟服务器,以便在我调用时:

mymockurl.com/users 它将返回一个预定义的json(无需连接到数据库).

最简单的方法是什么？我不是后躯.

我有一个下面定义的swagger 2.0资源.如何制作"param1或param2"？调用者必须传递param1或param2.

/some/res:
put:
  summary: some resource
  responses:
    200:
      description: Successful response
      schema:
        $ref: '#/definitions/SomeResponse'
  parameters:
    - name: param1
      type: string
      description: param1
      in: formData
      required: false
    - name: param2
      type: string
      description: param2
      in: formData
      required: false

我使用Swagger来记录我的REST服务.我的一项服务需要上传CSV文件.在JSON文件中为参数部分指定以下属性后,我可以在我的招摇页面上获取文件上载选项.

{
       "name": "File",
       "description": "The file in zip format.",
       "paramType": "body",
       "required": true,
       "allowMultiple": false,
       "dataType": "file"
}

但是当我选择一个文件然后点击我收到错误NS_ERROR_XPC_BAD_OP_ON_WN_PROTO:在jquery-1.8.0.min.js(第2行)中对WrappedNative原型对象进行非法操作时,它会不断处理,我没有得到任何响应.

使用带有 Java17 和 Spring Boot 3.0.0 的全新 Spring Initialzr，以及 Springfox Swagger 3 的 pom.xml 的额外补充，我一生都无法让 Swagger 页面工作。相反，我得到了带有 404 的白标错误页面。

Pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.0.0</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.example</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>demo</name>
<description>Demo project for Spring Boot</description>
<properties>
    <java.version>17</java.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-boot-starter</artifactId>
        <version>3.0.0</version>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>
</project>

此Github 问题页面 …