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 的某些功能需要適當的許可權利。