swagger-php相关内容

整个响应的声明在swagger-php中可以重复使用吗?

我希望有一种方法来声明对每个终结点都相同的一些响应;例如,如果您没有正确的令牌,每个终结点将输出401,如果您的路径开头没有有效的id,则可能有另一组终结点都将输出id。 因此,对于几乎每种方法,我发现自己复制粘贴的内容如下: * @OAResponse(response=401, description="If no token..."), * @OAResponse(respons ..
发布时间:2022-08-16 13:25:33 其他开发

我可以让 swagger-php 在查询字符串上使用数组吗?

我使用 Swagger-php.当我在查询字符串上定义一个参数时,它可以是一个数组.但据我所知,它不支持这种查询字符串: https://api.domain.tld/v1/objects?q[]=1&q[]=5&q[]=12 如果可能的话,我相信这会在collectionFormat字段中设置.目前我一直在使用 pipes,但我想使用上述格式,并且 Swagger-UI 也反映了这一点.但是 ..
发布时间:2021-09-01 20:23:25 PHP

swagger-php 具有来自相同代码的不同文档

我们正在使用 slim 框架和 swagger-php 来动态生成 swagger 文档.我们现在在 API 中有一些不应公开记录的特殊方法.(/现在文档)有什么方法可以让我获得第二个文档 url (/doc2),我可以在其中记录秘密方法和参数吗?(无需手工制作文档,只需使用 php 代码中的注释).谢谢. 解决方案 根据最新版本的 swagger-php,您可以指定在构建文档时排除扫描的 ..
发布时间:2021-09-01 20:21:10 PHP

Swagger 和 json-rpc

我正在尝试将 Swagger-ui 用于由 php 编写的 json-rpc 服务器.我使用 Swagger-PHP 为 Swagger-ui 生成 json 投诉容器.所以,我对 Swagger 很陌生,我对这样的方法使用了注释: /*** @SWG\资源(* apiVersion="0.2",* swaggerVersion="0.8",* basePath="http://mydomain ..
发布时间:2021-09-01 20:19:13 其他开发

同一方法的两条路径

一直在尝试使用 Swagger 为我的 PHP Rest API 生成文档,使用 swagger-php. 它工作得非常好,不太确定我是否喜欢由于文档而有大量评论块,但这不是问题. 我有两条路径: /user/[POST]/用户/登录 [POST] 它们都在我的 PHP 代码中调用了相同的方法:login(). 有没有办法让我说/user/[POST] 只是/user/log ..
发布时间:2021-09-01 20:18:23 其他开发

将 Swagger 规范 JSON 转换为 HTML 文档

对于一些用 PHP 编写的 REST API,我被要求创建 Swagger 文档,因为我不知道任何向那些现有 API 添加注释并创建这样的文档的简单方法,我现在使用 这个编辑器 来生成一些. 我保存了使用该编辑器创建的 JSON 和 YAML 文件,现在我需要创建最终的交互式 Swagger 文档(此声明可能听起来幼稚和含糊). 有人可以告诉我如何将 Swagger JSON 规范文件 ..
发布时间:2021-09-01 20:12:11 其他开发

如何在swagger ui中映射此数组json?

我正在使用PHP中的swagger ui,并且我正在尝试将json映射为 下方 { "category": { "id": 0, "name": "string" } } 我从swagger ui演示中尝试过,但是无法获得上述映射 json,我怎么能得到这个json映射,它的注释是什么? 请帮助 我的招摇类是 /** * @SWG\Def ..
发布时间:2019-11-26 23:05:54 JavaScript