gitlab 的本地实例不响应位于“/gitlab/doc/api/v4”中的 API 文档中的 REST 调用

Question

I have undertaking a master thesis project that uses the openapi.yaml files to auto generate test for REST-api web-services - This has lead me to host a local instance of gitlab, so that I can run the tool I am working on, on gitlab . 为此，我需要.yaml文件，其中包含 API 调用的文档。 此类文件可在 gitlab 源代码中找到，但该调用似乎不起作用。

一些电话有效，即：

http://localhost/api/v4/version http://localhost/api/v4/users http://localhost/api/v4/projects http://localhost/api/v4/groups

所有返回有意义的 JSON。

问题是文档中的很多调用都不起作用（返回“404 not found”），即：

http://localhost/api/v4/metadata http://localhost/api/v4/projects/{id}/access_tokens

以及文档中指定的更多调用。

问题是很多有效的调用都没有记录（除了“版本”调用之外的所有调用）。 我真的试图寻找一个替代的openapi.yaml文件，但收效甚微，我也很困惑为什么留在实际源代码中的文件不包含有意义的文档。 我忽略了什么吗？ 我目前正在使用 postman 并提供 sudo 身份验证令牌。

在此先感谢-我肯定忽略了一些东西！

目前，我试图通过谷歌搜索和浏览 swaggerhub.com 来寻找替代的openapi.yaml 。 我查看了 gitlab 的文档页面，但我还没有找到任何我没有的东西。

Answer 1

不幸的是，在撰写本文时，GitLab 并未为其所有 API 提供 OpenAPI 规范。 openapi.yml 中仅记录了API的一小部分。 有一个未解决的问题正在跟踪此改进。

目前，在线API 文档将成为您使用 GitLab API 的最佳信息来源。

至于您获得404响应的问题，最常见的原因是您使用的凭据对您尝试访问的项目/功能没有权限，或者您没有使用正确的身份验证方法。 另请记住，API 的某些功能需要适当的许可权利。