小编Wil*_*eng的帖子

我想用Swagger POST一个json体,像这样:

curl -H "Content-Type: application/json" -X POST -d {"username":"foobar","password":"xxxxxxxxxxxxxxxxx", "email": "foo@bar.com"}' http://localhost/user/register

目前,我有这个定义:

"/auth/register": {
        "post": {
            "tags": [
              "auth"
            ],
            "summary": "Create a new user account",
            "parameters": [
                {
                    "name": "username",
                    "in": "query",
                    "description": "The username of the user",
                    "required": true,
                    "type": "string"
                },
                {
                    "name": "password",
                    "in": "query",
                    "description": "The password of the user",
                    "required": true,
                    "type": "string",
                    "format": "password"
                },
                {
                    "name": "email",
                    "in": "query",
                    "description": "The email of the user",
                    "required": true,
                    "type": "string",
                    "format": …

我希望 OpenAPI 生成器（https://github.com/OpenAPITools/openapi-generator）能够根据 Spring Boot Data 中的实现在 API 中生成 Pageable 参数。我一直在尝试寻找一种合适的开箱即用的解决方案，但找不到。

理想情况下，此 Pageable 参数应仅按以下方式添加到 GET 方法：

default ResponseEntity<User> getUser(@ApiParam(value = "value",required=true) @PathVariable("id") Long id, **Pageable pageable**)

因此，在我的控制器中实现此接口后，我需要重写它并具有上述的 Pageable 参数。我不想有单独的大小或页面参数，这里只有这个可分页。

感谢您的任何提示和帮助！

我总是习惯使用适当的文档与其他团队共享我的节点端服务.根据此文档,他们将使用我的服务.

关于这一点,当我与其他人交谈时.他建议我用swagger.但我不知道如何集成到我的应用程序.

我的申请写在Express.我在谷歌搜索过这个,我没有找到任何好的教程.如果有人已经实施,你能建议我吗？哪个模块好,怎么样.

也很奇怪,他们是否swagger支持任何其他类似的Node平台.

谢谢

有没有人成功地使用 Swagger 代码生成器创建了一个可以在浏览器中使用的 TypeScript Fetch 客户端？我正在尝试在使用 TypeScript 的 React 应用程序中使用生成的 API 客户端。

虽然我已经成功生成了一个客户端（即 api.ts 文件），但我对它以以下导入开头的事实感到困惑：

import * as querystring from "querystring";
import * as url from "url";

import * as isomorphicFetch from "isomorphic-fetch";
import * as assign from "core-js/library/fn/object/assign";

interface Dictionary<T> { [index: string]: T; }
export interface FetchAPI { (url: string, init?: any): Promise<any>; }

...

虽然我可以成功找到 isomorphic-fetch 和 core-js 的 TypeScript 类型（即 @types），但我找不到查询字符串和 url 的类型。结果，我得到[ts] Cannot find module...了querystring，url还有assign进口。

这个客户端实际上不是打算在浏览器中使用吗？否则，任何人都可以为我在这里可能做错的事情提供任何建议吗？

在此先感谢您的帮助！

我想使用swagger codegen生成sdk,它可以让我生成带有Observable的sdk作为回调,如下所示:

@POST("oauth/token")
Observable <TokenResponse> getRepository(@Query("grant_type")String grantType);

我想通过我的API从我的数据库中请求一个表.但是,我不知道该表将包含多少列,或者它将包含哪些列.如何在Swagger中指定它？这就是我想做的事情:

paths:
  /reports/{id}:
    get:
      summary: Detailed results
      description: filler
      parameters:
        - name: id
          in: path
          description: filler
          required: true
          type: integer
          format: int64
      responses:
        200:
          description: OK
          schema:
            type: array
            items: 
              $ref: '#/definitions/DynamicObject'
definitions:
  DynamicObject:
    type: object
    properties:
      **$IDONTKNOWWHATTODO**

关于如何定义没有特定参数的JSON对象的任何想法？