rest相关内容

Spring Pageable 接口的 Swagger 文档

我使用 Spring Boot 开发了一个微服务.REST API 的文档是用 Swagger 制作的.一些 REST 资源利用 Spring 概念免费提供分页.下面是一个例子: @RequestMapping(value = "/buckets", method = GET)public PagedResources list(Pageable pageable, PagedResources ..
发布时间:2022-01-22 17:54:53 其他开发

使用静态文档大摇大摆

我希望使用 Swagger 来记录我的宁静界面.问题是我不想通过注释我的代码来自动生成我的文档.基本上我不想将我的内部数据模型耦合到接口公开的虚拟数据模型.看来我可以让我的服务器提供一个 Resources.json 文件,然后为每个资源处理程序提供一个相应的 JSON 文件.然而,当我尝试这个时,我在尝试定义 JSON 正确语法并提供正确的 HTTP 标头响应字段时遇到了很多小问题. 有人 ..
发布时间:2022-01-22 17:53:30 其他开发

如何使用 Swagger\OpenAPI 记录 GraphQL?

如何使用 Swagger 记录 GraphQL?我们有一个庞大的后端 REST API,最近部分开始使用 GraphQL.我们使用 Swagger 来记录 API. 问题是:如何使用 Swagger(OpenAPI) 来记录 GraphQL 端点?Swagger 或 GraphQL 的官方文档中绝对没有相关信息. 解决方案 GraphQL API 通常通过 GraphQL 服务器本身 ..
发布时间:2022-01-22 17:49:38 其他开发

良好的剩余代码生成和文档工具

我一直在考虑一种文档工具,用于为要在多个客户端中使用的 Web 服务构建后端,以及 OAuth 和多个修订的可能性.我已经了解养蜂场,但做了一些研究,我发现其他相当不错的 解决方案 承诺有利可图. RAML 似乎有望实现良好的代码生成和 api 可重用性.但它似乎无法创建模拟服务器.而且我不明白为什么不能使用 apiblueprint 为 REST API 生成客户端库和服务器端骨架. ..
发布时间:2022-01-22 17:47:38 其他开发

Swagger 可以根据现有的快速路由自动生成其 yaml 吗?

我继承了一个现有的 API,我想大张旗鼓地记录它,但我还不知道它的全部范围.Swagger(或其他中间件/工具)能否根据现有的快速路由自动生成 yaml(用于 swagger)? 对于我在其他问题上看到的情况,这似乎主要是一项手动工作,但我正在仔细检查这里是否有人找到解决此问题的方法. 解决方案 我在自动生成 Swagger json 和为我帮助构建的 API 手动编写它方面都有经验 ..
发布时间:2022-01-22 17:45:05 其他开发

从招摇响应中排除模型或属性

我在我的 apache cxf 项目中使用了 swagger,使用了 @Api 和 @ApiOperations 以及 @ApiParam 注释,并为其余服务生成了一个 api 文档. 但我想从模型属性或完整模块或属性属性中排除一些字段,如 EntityTag、StatusType 和 MediaType 等. 怎么做? 我正在从 db 获取数据并将其设置为用户对象并将该用户对象 ..
发布时间:2022-01-22 17:42:06 其他开发

Swagger 和 Swagger 的区别仇恨

谁能解释一下 Swagger 和 Swagger 之间的区别?讨厌.我可以搜索很多次但没有朋友可以解释这两个方面的正确详细答案. 解决方案 Swagger 和 HATEOAS IMO 之间的主要区别是,Swagger 仅适用于 RPC'esque API.然而,这些 API 实际上与 REST 几乎没有任何关系. 还有一个更广泛的误解,即通过 HTTP 交换的任何内容都自动是 RES ..
发布时间:2022-01-22 17:34:07 其他开发

在 Couchbase 中添加文档并缺少 JSON 正文

我正在尝试使用 Couchbase REST API 将文档添加到现有文档中.我只是在编写代码时在 Postman 中测试它. POST:http://:8091/pools/default/buckets//docs/testdoc1?rev=1标题:接受:应用程序/json授权:xxxxx身体:原始 JSON(应用程序/json){“姓名":“xxx",“地址 ..
发布时间:2022-01-22 15:17:37 其他开发

使用 Postman 将 multipart/data 发布到 Cakephp

我目前正在 Cakephp 3 中构建一个 RESTful API.我正在尝试通过 Postman chrome 扩展中的表单数据上传一个文件(带有一些附加数据).但是,我不确定如何获取通过请求接收到的数据. 邮递员表单数据 这是我尝试使用以下代码发送到 api 文件夹中的图片控制器的数据: 公共函数 add(){调试($this->request->data);$picture ..
发布时间:2022-01-22 15:10:38 其他开发

发布二进制文件时使用 Postman 访问 AWS API 网关的 AWS 签名错误

在使用原始 JSON 执行 GET 请求甚至 POST 请求时工作正常.但是发送文件会返回此错误: “我们计算的请求签名与您提供的签名不匹配.请检查您的 AWS 秘密访问密钥和签名方法.有关详细信息,请参阅服务文档.此请求的规范字符串应该是 'POST......." 凭据绝对正确. 解决方案 这是 7 月 3 日发布的已知问题:https://github.com/postm ..
发布时间:2022-01-22 15:08:13 其他开发

如何使用邮递员的 github api

我想通过邮递员使用 github api 在我的 github 帐户上创建一个文件. github api 用于在 github 帐户上创建文件: PUT/repos/:owner/:repo/contents/:path 谁能告诉我如何在邮递员中使用这个 api. 我有我的公共 github 帐户:https://github.com/ritzygithub/myfirstRep ..
发布时间:2022-01-22 15:06:36 其他开发

为什么我得到不支持的请求方法 GET?

我使用 PostMan 作为 REST 客户端来测试这个 API 方法 思科 ACL 分析 API.特别是 POST/acl/trace 或 getAClTracksStd(首先进入策略分析) 这是我的 PostMan HTTP 测试调用 熟悉 PostMan 的人是否理解我为什么会从服务器收到此“不支持请求方法 'GET'"错误?我正在发出 POST HTTP 请求,而不是 GET. ..
发布时间:2022-01-22 15:03:37 其他开发