OpenAPI 文件

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

Roblox 發佈了一個 OpenAPI 3.0.4 文件(前身為 Swagger 文件),該文件包含了 所有 的 Roblox Cloud API。您可以在開源的 creator-docs 倉庫中找到這個文件,openapi.json

您可以使用 OpenAPI 文件與像是 Swagger EditorPostman 這樣的工具來測試調用並幫助簡化開發。像是 OpenAPI Generator 這樣的工具也可以為您首選的程式語言生成客戶端庫。


供應商擴展

Roblox 使用 規範擴展 來擴展 OpenAPI 規範。這些擴展代表了規範默認未捕獲的信息。擴展可能會出現在文件中 OpenAPI 規範允許的地方。

這些規範擴展中的大多數是實驗性的。所使用的擴展可能會在不通知的情況下變更,以支持官方 OpenAPI 規範中找到的字段。

擴展名稱位置描述
x-roblox-extensions-versionOpenAPI 物件版本字串,使用語義版本控制,表示這裡指定的擴展和其他常見結構的版本
x-roblox-stability操作物件表示操作穩定性級別的字串。
x-roblox-deprecated操作物件提供有關端點棄用狀態的額外信息的物件。
x-roblox-alternatives操作物件提供有關端點替代方案的額外信息的物件。
x-roblox-rate-limits操作物件提供有關端點的速率限制信息的物件。
x-roblox-scopes操作物件提供與端點相關的必要、條件和可選範圍列表的物件。
x-roblox-engine-usability操作物件表示端點在 Roblox 引擎中的可用性的物件。