SuperAPI AI 工具集

roblox-cloud

编程与开发

查看项目

更新于 10-17 16:13

技能介绍

roblox-cloud 用于处理以 Roblox Open Cloud 和 HTTP 集成(而非常规玩法脚本)为主的任务。典型用途包括:构建调用 Roblox Web API 的 CI、机器人、Web 后端、脚本或内部工具;为非用户自动化选择 API 密钥并确认端点的必需作用域;构造请求 URL、请求体、过滤器、请求头、分页、更新掩码和长时间运行操作的轮询;处理 Open Cloud 错误、配额限制、重试和限流响应头;判断某端点能否在体验内通过 HttpService 使用;以及在 Discord、Slack 或自定义 HTTPS 端点接收 Roblox Webhooks。

主要能力围绕请求构造与集成边界展开:默认为非用户自动化使用 API 密钥;在编码前确认基础 URL、路径模板、路径与查询参数、请求体模式、所需作用域、速率限制,以及体验内调用时是否支持 HttpService。请求构造方面强调精确插入路径参数、分页查询保持稳定、JSON 请求体加 Content-Type、API 密钥请求携带 x-api-key、updateMask 只用于打算修补的字段。响应处理包括读取 nextPageToken 分页、对长时间运行调用以退避方式轮询 Operation 资源、正确解析 Open Cloud 的 JSON 类型(时间戳、时长、字节、字段掩码、小数)。

失败路径处理涵盖 INVALID_ARGUMENT(核对 ID、过滤器、请求头与请求体形态)、PERMISSION_DENIED 或 INSUFFICIENT_SCOPE(核对作用域与资源访问)、RESOURCE_EXHAUSTED 或 HTTP 429(遵循 retry-after,否则指数退避)、UNAVAILABLE 等瞬时故障(退避重试而非紧循环)。Webhook 方面要求公网 HTTPS POST 端点、5 秒内返回 2XX、配置密钥时校验 roblox-signature、按 NotificationId 去重、把投递视为可重试且可能重复。HttpService 场景另有平台约束:仅支持部分 Open Cloud 端点、仅允许 x-api-key 与 content-type 请求头、x-api-key 须来自 Secret、仅 HTTPS、路径参数不可包含 ..。

使用方式上,该技能提供一组参考文件:open-cloud-overview.md 用于理解 Open Cloud 与旧式或体验内调用的高层模型;cloud-guides.md 用于匹配已知工作流的指南起点;api-patterns-errors-types-scopes-and-rate-limits.md 用于请求构造、分页、字段掩码、错误、作用域与重试;webhooks-documentation.md 用于触发支持、负载形态、签名校验与投递预期;http-service.md 用于体验内请求的端点支持校验;openapi-documentation.md 用于检查或基于统一 OpenAPI 描述生成客户端;cloud-reference-json-files.md 用于从本地 JSON 工件挖掘操作 ID、模式、作用域或引擎可用性元数据。

适用场景为外部自动化、Webhook 接收方与体验内 HttpService。限制与边界明确:OAuth 应用注册、授权流程、令牌交换、刷新处理与用户委托同意不在本技能范围,应移交 roblox-oauth;DataStore 或 MemoryStore 模式设计、保存架构与跨服务器数据策略移交 roblox-data;玩法远程、复制与通用引擎脚本移交 roblox-networking;仅引擎 API 查询移交 roblox-api。若请求混合了云集成与范围外架构,仅回答 Open Cloud 部分并明确排除其余内容。