我进行了一个主论文项目,该项目使用openapi.yaml
文件自动生成REST-api服务测试--这导致我在gitlab上托管一个本地实例,这样我就可以在gitlab上运行我正在开发的工具。为此,我需要包含API调用文档的.yaml
文件。这样的文件可以在gitlab源代码中找到,但是调用似乎不起作用。
有些人称之为工作,即:
http://localhost/api/v4/version
http://localhost/api/v4/users
http://localhost/api/v4/projects
http://localhost/api/v4/groups
所有返回有意义的JSON。
问题是文档中的许多调用不起作用(返回一个"404 not“),即:
http://localhost/api/v4/metadata
http://localhost/api/v4/projects/{id}/access_tokens
以及文档中指定的更多调用。
问题是,许多工作调用都没有文档化(除了“版本”调用之外,所有这些都没有记录)。我确实尝试过寻找替代的openapi.yaml
文件,但是没有取得什么成功,我也很困惑为什么在实际的源代码中留下的文件没有包含有意义的文档。我忽略了什么吗?我目前正在使用邮递员,并提供一个sudo认证-令牌。
事先谢谢--我一定是漏掉了什么!
目前,我已经尝试通过谷歌搜索和浏览openapi.yaml
来寻找替代的swaggerhub.com。我已经查看了gitlab的文档页面,但是我还没有发现任何我还没有的东西。
发布于 2022-09-09 15:00:16
不幸的是,在编写本报告时,GitLab没有为其所有API提供OpenAPI规范。在openapi.yml中只记录了API的一小部分。有一个公开发行正在跟踪这一改进。
现在,在线API文档将成为您使用GitLab API的最佳信息来源。
至于获取404
响应的问题,最常见的原因是您正在使用的凭据不具有您要访问的项目/特性的权限,或者您没有使用正确的认证方法。此外,请记住API的一些特性需要一个适当的许可权限。
https://stackoverflow.com/questions/73662864
复制相似问题