用途:面向 Roblox 开发者,说明如何通过 Open Cloud REST API 与游戏内 HttpService 从外部管理体验资源,基址为 https://apis.roblox.com,优先使用稳定的 Open Cloud 端点,避免依赖可能随时失效的旧版 cookie 认证 web API。
认证:API 密钥在 Creator Dashboard 的 Open Cloud 中创建,按 universe 授予最小 scope,设置 IP 允许列表与过期时间,存为密钥并以 x-api-key 头发送;群组资源需在群组下建密钥,可用 POST /api-keys/v1/introspect 校验。OAuth 2.0(授权码 + PKCE)用于代表其他用户的第三方工具。密钥不得写入游戏脚本或客户端代码。
主要能力:数据存储条目(GET/POST/PATCH/DELETE、:increment、:listRevisions)、有序数据存储、内存存储(sorted-maps、queues)、向在线服务器发消息 POST /cloud/v2/universes/{u}:publishMessage、发布地点文件、重启服务器 :restartServers、云端运行 Luau、封禁 user-restrictions、体验通知、Secrets 存储、配置与实验、universe/place 设置,以及资产、徽章、通行证等。
使用方式:分页用 maxPageSize 与 nextPageToken/pageToken;长任务轮询 operation 路径;列表支持 filter;读取 x-ratelimit-* 头,遇 429 指数退避加抖动;错误为 JSON {code,message},仅重试 429 与 5xx。数据存储预算与在线服务器共享,批量脚本需限流。
游戏内 HttpService:需在体验设置中开启 Allow HTTP Requests,仅服务端可用;外部 URL 每服务器 500 请求/分钟,Open Cloud 调用另有 2500/分钟预算;用 pcall 处理非 2xx。密钥存于 Secrets 存储,用 HttpService:GetSecret 读取。仅部分 Open Cloud 端点可从游戏调用,其他 roblox.com 域被阻止。游戏内优先用原生 API(如 Players:BanAsync、DataStoreService)。Webhook 在 Creator Dashboard 配置,触发订阅、退款、擦除请求等事件。
限制:权威端点、scope 与速率限制以 Open Cloud 参考文档为准;不得将玩家聊天或 PII 未经合规审查发送给第三方。