接口文档 · 服务端下发
Roblox 跳转
Roblox 跳转
接口文档
GET 调用，参数校验后由服务端返回本次跳转目标；页面弹出提示并尝试唤起 Roblox 客户端。目录、参数规则与示例均由服务端下发，与线上行为一致。
GET /api/catalog.php
GET /api/resolve.php
application/json
catalog / resolve
200 ok
no-store
GET /api/catalog.php
← 200 { "groups": [ … ], "enums": [ … ] }
目录视图不含任何跳转模板
GET /api/resolve.php?type=game&gameId=920587237
← 200 { "ok": true, "kind": "deep", "web": "…" }
仅返回本次请求的目标，不返回整份目录
0跳转类型
0功能分组
0参数总数
0必填参数
接口信息
两个接口，一次跳转
清单接口用于渲染本页与调试表单；解析接口按参数返回本次请求的目标地址与网页兜底。
通用参数
所有类型共用
| 参数名 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type |
否 | 枚举 | 跳转类型，取值见下方清单。省略时按参数名推断：只传 placeId 视为 start，只传 userId 视为 profile_card，只传 gameId 视为 game，只传 groupId 视为 group，只传 itemId 视为 item |
start |
key |
否 | 字符串 | 同一 type 下的子项选择，目前仅 settings 使用（如 privacy_settings） |
privacy_settings |
auto |
否 | 0 / 1 | 是否自动唤起客户端，默认 1；auto=0 只拉取结果并展示按钮，不自动跳转。自动唤起由页面用隐藏 iframe 触发自定义协议（顶层页面不跳走，也不依赖用户手势） |
0 |
fb |
否 | 枚举 | 未检测到客户端（1~1.5 秒内页面未被 App 接管）时的兜底策略：deferred 延迟深链（默认手机端：先引导下载、装完再跳转）、web 网页版（默认桌面端）、none 不自动兜底只保留手动按钮。用户任何点击都会取消待执行的兜底。QQ 内置浏览器例外：无法识别客户端安装情况，直接跳转 Roblox 官方引导页（ro.blox.com），不执行本地 scheme 尝试 |
none |
其余参数随 type 变化，见下方各条目的「请求参数」表；同名参数在不同类型中含义可能不同，请勿跨类型复用。
跳转类型清单
全部类型与请求参数
下列内容由 GET /api/catalog.php 下发；示例请求可直接点击测试。
参数值速查
枚举与取值
占位符对照
文档占位符 → 本入口参数
官方与社区文档中的 <xxxid> 占位符对应关系。
响应说明
一次调用的完整链路
能力边界