SuperAPI AI 工具集

roblox-cloud

编程与开发

查看项目

更新于 10-16 00:02

技能介绍

用途:本技能聚焦 Roblox Open Cloud 与游戏外 HTTP 集成工作,而非普通玩法脚本。适用场景包括:构建调用 Roblox Web API 的 CI、机器人、Web 后端、脚本或内部工具;为非用户自动化选择 API 密钥并检查端点所需 scope;构造请求 URL、请求体、过滤器、请求头、分页、updateMask 及长时任务轮询;处理 Open Cloud 错误、配额、重试与速率限制头;判断某端点能否在体验内由 HttpService 调用;在 Discord、Slack 或自定义 HTTPS 端点接收 Roblox webhook;读取 openapi.json、cloud.docs.json 或服务级 JSON 以生成客户端或检查端点元数据。

不适用范围:OAuth 应用注册、授权流程、令牌交换与刷新、用户委托同意;DataStore 或 MemoryStore 的 schema 设计、存档架构与跨服务器数据策略;玩法 remotes、复制与通用引擎脚本。遇到这些应移交 roblox-oauth、roblox-data、roblox-networking 或 roblox-api。

主要能力与用法:调用方为服务器、CI、机器人、webhook 工作进程或无需终端用户同意的体验内自动化时,优先使用 API 密钥;需要用户委托访问时改用 OAuth 技能。编码前确认基址与路径模板、路径与查询参数、请求体 schema、所需 scope、速率限制,以及体验内调用时 HttpService 是否受支持。构造请求时精确填入路径参数,分页查询在各页保持一致,JSON 请求体加 Content-Type: application/json,API 密钥认证发送 x-api-key,仅对要修补的字段使用 updateMask。响应侧读取 nextPageToken 分页,对长时调用按退避轮询 Operation 资源,正确处理时间戳、时长、字节、字段掩码与小数等 JSON 类型。错误处理:INVALID_ARGUMENT 检查 ID、过滤器、请求头与请求体;PERMISSION_DENIED 或 INSUFFICIENT_SCOPE 检查 scope 与资源权限;RESOURCE_EXHAUSTED 或 HTTP 429 遵从 retry-after,否则指数退避;UNAVAILABLE 等瞬时故障退避重试而非紧循环。Webhook 需公网 HTTPS POST 端点、5 秒内返回 2XX、配置密钥时验证 roblox-signature、按 NotificationId 去重,并视为可重试且可能重复投递。HttpService 附加限制:仅支持受支持的 Open Cloud 端点,仅允许 x-api-key 与 content-type 头,密钥须来自 Secret,仅 HTTPS,路径参数不得含 ..。

限制:不要在本技能中实现 OAuth 流程;不要假设所有 Open Cloud 端点都能被 HttpService 调用;不要把 API 密钥明文存储;注意密钥 scope 与创作者权限均需满足;分页时不要更改过滤参数;不要忽略 Operation 轮询;不要紧循环重试 429/503;webhook 处理要快速返回 2XX 并异步处理。具体端点清单、费用与平台细节暂未提供。