{"version":"1.2.0","updated":"2026-09-11","site":"https://rbx.astudlox.top","doc":"https://rbx.astudlox.top/docs/","groups":[{"id":"game","name":"游戏 / 加入服务器","items":[{"type":"start","label":"StartExperience","desc":"启动指定体验（游戏根地点 Place）","web":"https://www.roblox.com/games/start","webOnly":false,"note":"官方支持。本入口支持省略 type 的简写形式（只传 placeId 即为本类型）。","params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"}]},{"type":"start_user","label":"StartByUser","desc":"跟随指定用户进入其当前所在服务器（对方需在游戏中）","webOnly":false,"params":[{"name":"userId","required":true,"type":"number","desc":"目标用户 ID","sample":"1"}]},{"type":"start_private","label":"StartPrivateServer","desc":"进入指定体验的私服（VIP 服务器）","webOnly":false,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"accessCode","required":true,"type":"text","desc":"私服访问密钥（VIP 服务器 accessCode）","sample":"abc123xyz"}]},{"type":"start_linkcode","label":"StartByLinkCode","desc":"通过分享链接码进入体验","webOnly":false,"params":[{"name":"linkCode","required":true,"type":"text","desc":"分享链接码 share link code","sample":"abc123xyz"}]},{"type":"start_instance","label":"StartSpecificInstance","desc":"进入指定服务器实例（同一个 JobId）","webOnly":false,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"gameInstanceId","required":true,"type":"uuid","desc":"服务器实例 UUID（JobId）","sample":"2f8b1c44-9f0e-4a71-9f0b-1d6a2c33ab77"}]},{"type":"start_reserved","label":"StartReservedServer","desc":"进入预留服务器（Reserved Server）","webOnly":false,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"reservedServerAccessCode","required":true,"type":"text","desc":"预留服务器访问码","sample":"reserved-code"}]},{"type":"start_launchdata","label":"StartWithLaunchData","desc":"带 launchData 启动体验（数据交给游戏内脚本读取）","web":"https://www.roblox.com/games/start","webOnly":false,"note":"launchData 完全可见于 URL 且用户可修改，切勿传入敏感信息或用于鉴权。","params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"launchData","required":true,"type":"launchData","desc":"启动数据，单次 URL 编码后解码不超过 200 字节","sample":"{\"roomId\": 2}","maxBytes":200}]},{"type":"start_event","label":"StartWithEvent","desc":"由指定活动（Event）启动体验","webOnly":false,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"eventId","required":true,"type":"number","desc":"活动 ID","sample":"1"}]},{"type":"start_join","label":"StartWithJoinAttempt","desc":"带 joinAttemptId 启动体验","webOnly":false,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"joinAttemptId","required":true,"type":"text","desc":"加入尝试 ID","sample":"attempt-1"}]},{"type":"game","label":"GameDetails","desc":"打开体验详情页（不直接进服务器）","web":"https://www.roblox.com/games/{gameId}","webOnly":false,"params":[{"name":"gameId","required":true,"type":"number","desc":"体验（Universe/Game）ID","sample":"920587237"}]},{"type":"game_private","label":"GameDetailsPrivate","desc":"打开体验详情页并带入私服链接码","web":"https://www.roblox.com/games/{gameId}","webOnly":false,"params":[{"name":"gameId","required":true,"type":"number","desc":"体验 ID","sample":"920587237"},{"name":"privateServerLinkCode","required":true,"type":"text","desc":"私服链接码","sample":"abc123xyz"}]},{"type":"webstart","label":"WebToApp","desc":"先打开网页游戏页，再由网页拉起客户端（纯网页形态）","web":"https://www.roblox.com/games/start","webOnly":true,"params":[{"name":"placeId","required":true,"type":"number","desc":"游戏根地点 ID","sample":"6900305353"},{"name":"launchData","required":false,"type":"launchData","desc":"启动数据（可选）","sample":"{\"roomId\": 2}","maxBytes":200}]}]},{"id":"nav","name":"导航 / 主页","items":[{"type":"home","label":"Home","desc":"打开客户端首页","web":"https://www.roblox.com/home","webOnly":false,"params":[]},{"type":"charts","label":"Charts","desc":"打开排行榜","web":"https://www.roblox.com/charts","webOnly":false,"params":[]},{"type":"friends","label":"FriendsList","desc":"打开好友列表","web":"https://www.roblox.com/users/friends","webOnly":false,"params":[]},{"type":"more","label":"More","desc":"打开「更多」页","webOnly":false,"params":[]},{"type":"avatar","label":"AvatarEditor","desc":"打开装扮编辑器","web":"https://www.roblox.com/my/avatar","webOnly":false,"params":[]},{"type":"avatar_item","label":"AvatarEditorWithItem","desc":"打开装扮编辑器并定位到指定物品","webOnly":false,"params":[{"name":"itemType","required":false,"type":"enum","desc":"物品类型","sample":"Asset","values":[{"v":"Asset","label":"单件装扮"},{"v":"Bundle","label":"套装"},{"v":"Look","label":"造型"}],"def":"Asset"},{"name":"itemId","required":true,"type":"number","desc":"物品 ID","sample":"1365767"}]},{"type":"catalog","label":"Catalog","desc":"打开客户端商城首页","web":"https://www.roblox.com/catalog","webOnly":false,"note":"客户端商城不接受任何搜索/筛选参数；需要搜索请用 type=search（网页端商城搜索）。","params":[]},{"type":"sort","label":"SortByName","desc":"按分类名打开商城分类","webOnly":false,"params":[{"name":"sortName","required":true,"type":"text","desc":"分类名","sample":"Featured"}]},{"type":"sort_id","label":"SortById","desc":"按分类 ID 打开商城分类","webOnly":false,"params":[{"name":"sortId","required":true,"type":"number","desc":"分类 ID","sample":"1"}]},{"type":"exp_sort","label":"ExperienceSortByName","desc":"按分类名打开体验分类","webOnly":false,"params":[{"name":"sortName","required":true,"type":"text","desc":"分类名","sample":"Popular"}]},{"type":"exp_sort_id","label":"ExperienceSortById","desc":"按分类 ID 打开体验分类","webOnly":false,"params":[{"name":"sortId","required":true,"type":"number","desc":"分类 ID","sample":"1"}]}]},{"id":"avatar","name":"装扮 / 物品","items":[{"type":"item","label":"ItemDetails","desc":"打开物品详情页（Asset / Bundle / Look）","web":"https://www.roblox.com/catalog/{itemId}","webOnly":false,"params":[{"name":"itemType","required":false,"type":"enum","desc":"物品类型","sample":"Asset","values":[{"v":"Asset","label":"单件装扮"},{"v":"Bundle","label":"套装"},{"v":"Look","label":"造型"}],"def":"Asset"},{"name":"itemId","required":true,"type":"number","desc":"物品 ID","sample":"1365767"}]},{"type":"equip","label":"EquipAsset / EquipBundle","desc":"穿戴已拥有的物品（不是购买）","webOnly":false,"note":"catalog/equip 只能穿戴已拥有的物品，不产生购买。","params":[{"name":"itemType","required":false,"type":"enum","desc":"物品类型","sample":"Asset","values":[{"v":"Asset","label":"单件装扮 assetId"},{"v":"Bundle","label":"套装 bundleId"}],"def":"Asset"},{"name":"itemId","required":true,"type":"number","desc":"物品 ID","sample":"1365767"}]},{"type":"search","label":"CatalogSearch","desc":"网页端商城搜索（www.roblox.com 为 App Links 主机，打开后会拉起客户端）","web":"https://www.roblox.com/catalog","webOnly":true,"params":[{"name":"Keyword","required":false,"type":"text","desc":"关键词（只匹配物品标题）","sample":"hat"},{"name":"Category","required":false,"type":"number","desc":"分类，见参数值速查","sample":"11"},{"name":"Subcategory","required":false,"type":"number","desc":"子类，见参数值速查","sample":"19"},{"name":"SortType","required":false,"type":"number","desc":"排序，见参数值速查","sample":"4"},{"name":"SortAggregation","required":false,"type":"number","desc":"时间范围，见参数值速查","sample":"5"},{"name":"MinPrice","required":false,"type":"number","desc":"最低价（Robux）","sample":"0"},{"name":"MaxPrice","required":false,"type":"number","desc":"最高价（Robux）","sample":"100"},{"name":"CreatorName","required":false,"type":"text","desc":"创作者名","sample":"Roblox"},{"name":"CreatorType","required":false,"type":"number","desc":"创作者类型：1 用户 / 2 群组（与 CreatorTargetId 成对）","sample":"1"},{"name":"CreatorTargetId","required":false,"type":"number","desc":"创作者 ID（与 CreatorType 成对）","sample":"1"},{"name":"Limit","required":false,"type":"number","desc":"数量：10 / 28 / 30 / 60 / 120","sample":"30"}]}]},{"id":"user","name":"用户 / 社群 / 聊天","items":[{"type":"profile_card","label":"ProfileCard","desc":"唤起原生资料卡弹窗","webOnly":false,"params":[{"name":"userId","required":true,"type":"number","desc":"目标用户 ID","sample":"1"}]},{"type":"profile","label":"FullProfile","desc":"打开完整资料页","webOnly":false,"params":[{"name":"userId","required":true,"type":"number","desc":"目标用户 ID","sample":"1"},{"name":"friendshipSourceType","required":false,"type":"text","desc":"好友来源类型（可选）","sample":"profile"}]},{"type":"profile_group","label":"ProfileGroup","desc":"打开群组资料页","webOnly":false,"params":[{"name":"groupId","required":true,"type":"number","desc":"群组 ID","sample":"7"}]},{"type":"group","label":"GroupHome","desc":"打开群组主页（可定位到论坛分类）","webOnly":false,"params":[{"name":"groupId","required":true,"type":"number","desc":"群组 ID","sample":"7"},{"name":"forumCategoryId","required":false,"type":"number","desc":"论坛分类 ID（可选）","sample":"1"}]},{"type":"content_posts","label":"ContentPosts","desc":"打开用户帖子","webOnly":false,"params":[{"name":"userId","required":true,"type":"number","desc":"用户 ID","sample":"1"},{"name":"postId","required":true,"type":"number","desc":"帖子 ID","sample":"1"}]},{"type":"contacts","label":"Contacts","desc":"打开联系人/社交入口（可带物品 ID）","webOnly":false,"params":[{"name":"contactId","required":true,"type":"number","desc":"联系人 ID","sample":"1"},{"name":"assetId","required":false,"type":"number","desc":"物品 ID（可选）","sample":"1365767"}]},{"type":"chat","label":"Chat / ChatById","desc":"打开聊天会话","webOnly":false,"note":"userId 与 chatId 至少传一个：传 userId → 单聊；传 chatId → 指定会话（可带 entryPoint）。","params":[{"name":"userId","required":false,"type":"number","desc":"与指定用户单聊（与 chatId 二选一）","sample":"1"},{"name":"chatId","required":false,"type":"number","desc":"指定会话 ID（与 userId 二选一）","sample":"1"},{"name":"entryPoint","required":false,"type":"text","desc":"入口来源，配合 chatId 使用","sample":"notification"}]}]},{"id":"share","name":"分享 / 登录 / 其他","items":[{"type":"share","label":"ShareLinks","desc":"解析分享链接（好友邀请 / 体验邀请 / 私服邀请等）","webOnly":false,"note":"入口参数名用 shareType 以免与调度参数 type 冲突。","params":[{"name":"shareType","required":true,"type":"text","desc":"分享类型","sample":"ExperienceInvite"},{"name":"code","required":true,"type":"text","desc":"分享码","sample":"abc123xyz"}]},{"type":"crossdevice","label":"CrossDevice","desc":"跨设备登录确认","web":"https://www.roblox.com/crossdevicelogin/confirmcode","webOnly":false,"params":[{"name":"code","required":true,"type":"text","desc":"跨设备登录码","sample":"ABCD-1234"}]},{"type":"gift_cards","label":"GiftCards","desc":"打开礼品卡页面","webOnly":false,"params":[]},{"type":"event","label":"EventDetails","desc":"打开活动详情","webOnly":false,"params":[{"name":"eventId","required":true,"type":"number","desc":"活动 ID","sample":"1"}]},{"type":"qr_redeem","label":"QRRedemption","desc":"扫码兑换物品","webOnly":false,"params":[{"name":"itemType","required":false,"type":"enum","desc":"物品类型","sample":"Asset","values":[{"v":"Asset","label":"单件装扮"},{"v":"Bundle","label":"套装"},{"v":"Look","label":"造型"}],"def":"Asset"},{"name":"itemId","required":true,"type":"number","desc":"物品 ID","sample":"1365767"}]},{"type":"web_link","label":"ExternalWebLink","desc":"App 内 webview 打开帮助中心文章","webOnly":false,"params":[{"name":"domain","required":true,"type":"text","desc":"域名","sample":"en.help.roblox.com"},{"name":"locale","required":false,"type":"text","desc":"语言地区（可选）","sample":"en_us"},{"name":"articleId","required":true,"type":"number","desc":"文章 ID","sample":"203445784"}]},{"type":"appeals","label":"Appeals","desc":"打开申诉页","webOnly":false,"params":[{"name":"vid","required":true,"type":"text","desc":"申诉 ID","sample":"1"}]},{"type":"security_alert","label":"SecurityAlert","desc":"安全反馈（payload 携带安全数据）","webOnly":false,"params":[{"name":"payload","required":true,"type":"text","desc":"安全反馈数据","sample":"abc"}]}]},{"id":"settings","name":"设置类（App 内 webview）","note":"同一 type=settings 通过 &key=<名称> 选择具体设置页，例如 /?type=settings&key=privacy_settings。","items":[{"type":"settings","key":"account_info","label":"AccountInfo","desc":"账户信息","web":"https://www.roblox.com/my/account#!/info","webOnly":false,"params":[]},{"type":"settings","key":"notification_settings","label":"NotificationSettings","desc":"通知设置","web":"https://www.roblox.com/my/account#!/notifications","webOnly":false,"params":[]},{"type":"settings","key":"privacy_settings","label":"PrivacySettings","desc":"隐私设置","web":"https://www.roblox.com/my/account#!/privacy","webOnly":false,"params":[]},{"type":"settings","key":"parental_controls","label":"ParentalControls","desc":"家长控制","web":"https://www.roblox.com/my/account#!/parental-controls","webOnly":false,"params":[]},{"type":"settings","key":"spending_settings","label":"SpendingSettings","desc":"消费限制","webOnly":false,"params":[]},{"type":"settings","key":"app_permissions_settings","label":"AppPermissions","desc":"应用权限","webOnly":false,"params":[]},{"type":"settings","key":"avatar_clothing_sort","label":"AvatarClothingSort","desc":"装扮排序","webOnly":false,"params":[]},{"type":"settings","key":"avatar_profile_picture_editor","label":"AvatarProfilePictureEditor","desc":"头像编辑","webOnly":false,"params":[]},{"type":"settings","key":"screentime_subsettings","label":"ScreenTime","desc":"屏幕时间","webOnly":false,"params":[]},{"type":"settings","key":"blocked_experiences_subsettings","label":"BlockedExperiences","desc":"已屏蔽体验","webOnly":false,"params":[]},{"type":"settings","key":"blocked_users_subsettings","label":"BlockedUsers","desc":"已屏蔽用户","webOnly":false,"params":[]},{"type":"settings","key":"experience_chat_subsettings","label":"ExperienceChat","desc":"体验内聊天","webOnly":false,"params":[]},{"type":"settings","key":"party_subsettings","label":"Party","desc":"组队","webOnly":false,"params":[]},{"type":"settings","key":"voice_subsettings","label":"Voice","desc":"语音","webOnly":false,"params":[]},{"type":"settings","key":"trading_inventory_subsettings","label":"TradingInventory","desc":"交易与库存","webOnly":false,"params":[]},{"type":"settings","key":"friends_contacts_subsettings","label":"FriendsContacts","desc":"好友与联系人","webOnly":false,"params":[]},{"type":"settings","key":"private_server_subsettings","label":"PrivateServer","desc":"私服设置","webOnly":false,"params":[]},{"type":"settings","key":"visibility_subsettings","label":"Visibility","desc":"可见性","webOnly":false,"params":[]}]},{"id":"desktop","name":"桌面端协议（Windows / macOS）","items":[{"type":"app","label":"LaunchDesktopApp","desc":"仅启动桌面客户端","webOnly":false,"params":[]},{"type":"player","label":"LaunchDesktopToPlace","desc":"按 roblox-player 格式启动（play 模式）","webOnly":false,"note":"各参数以 + 拼接、键与值之间用 : 分隔，写法与普通查询串不同。","params":[{"name":"robloxLocale","required":false,"type":"text","desc":"客户端语言","sample":"zh_cn"},{"name":"gameLocale","required":false,"type":"text","desc":"游戏内语言","sample":"zh_cn"},{"name":"LaunchExp","required":false,"type":"text","desc":"启动实验标识","sample":"InApp"}]}]},{"id":"advanced","name":"延迟深链 / 高级","items":[{"type":"deferred","label":"DeferredDeepLink","desc":"AppsFlyer 延迟深链：未安装客户端时先引导下载，装完再跳转","webOnly":false,"special":"deferred","note":"推荐用 target=<类型>&<该类型的参数> 写法，由目录自动生成延迟深链；生成的 ro.blox.com 链接中 & 会编码为 %26（af_dp / deep_link_value 双重编码）。","params":[{"name":"dp","required":true,"type":"text","desc":"已装客户端时跳转的 roblox:// 深链","sample":"roblox://(自定义深链)"},{"name":"web","required":false,"type":"text","desc":"未装客户端时的网页兜底（默认同 dp 的网页形态，可省略）","sample":"https://www.roblox.com/games/start?placeId=6900305353"}]},{"type":"raw","label":"Raw","desc":"直接透传自定义 scheme 深链（仅允许 roblox:// 与 roblox-player: 前缀）","webOnly":false,"special":"raw","note":"用于目录未覆盖的深链；服务端与前端均限制前缀，避免被当作任意协议跳板。","params":[{"name":"dp","required":true,"type":"text","desc":"完整深链","sample":"roblox://(自定义深链)"}]}]}],"enums":[{"name":"Category（分类）","rows":[["0","Featured"],["1","All"],["2","Collectibles"],["3","Clothing"],["4","BodyParts"],["5","Gear"],["11","Accessories"],["12","AvatarAnimations"],["13","CommunityCreations"]]},{"name":"Subcategory（子类）","rows":[["9","Hats"],["10","Faces"],["12","Shirts"],["13","TShirts"],["14","Pants"],["15","Heads"],["19","Accessories"],["20","HairAccessories"],["22","NeckAccessories"],["23","ShoulderAccessories"],["25","BackAccessories"],["26","WaistAccessories"],["27","AvatarAnimations"],["37","Bundles"],["54","HeadAccessories"],["66","DynamicHeads"]]},{"name":"SortType（排序）","rows":[["0","Relevance（默认）"],["1","Favorited"],["2","Sales"],["3","Updated"],["4","PriceAsc（低→高）"],["5","PriceDesc（高→低）"]]},{"name":"SortAggregation（时间）","rows":[["1","PastDay"],["3","PastWeek"],["4","PastMonth"],["5","AllTime"]],"note":"仅在 SortType=1 或 2 时有意义。"},{"name":"CreatorType（创作者类型）","rows":[["1","User（需与 CreatorTargetId 成对）"],["2","Group（需与 CreatorTargetId 成对）"]]},{"name":"Limit（返回数量）","rows":[["10","10 条"],["28","28 条"],["30","30 条"],["60","60 条"],["120","120 条"]]}],"placeholders":[["<游戏根地点id>","体验启动 Place 的 ID","placeId"],["<目标用户id>","用户 ID","userId"],["<体验id>","体验（Universe/Game）ID","gameId"],["<群组id>","群组 ID","groupId"],["<物品id>","Asset / Bundle / Look 的 ID","itemId"],["<单品assetid>","单件装扮 Asset ID","itemId"],["<套装bundleid>","Bundle ID","itemId"],["<造型id>","Look ID","itemId"],["<服务器实例uuid>","服务器 JobId","gameInstanceId"],["<私服访问密钥> / <私服链接码>","VIP 服务器 accessCode","accessCode"],["<分享链接码> / <分享码>","share link code","linkCode"],["<预留服务器码>","Reserved Server access code","reservedServerAccessCode"],["<url编码启动数据>","launchData，需 URL 编码","launchData"],["<活动id>","Event ID","eventId"],["<会话id>","Chat conversation ID","chatId"],["<帖子id>","Content post ID","postId"]],"limitations":[{"title":"官方 deep links 已标记 deprecated","text":"Roblox 官方文档标注该流程已废弃，建议新项目优先使用 Share Link API 生成分享链接；roblox:// 目前仍可用。"},{"title":"部分跳转类型来自社区逆向整理","text":"Roblox 未承诺兼容，客户端版本更新后可能失效，生产环境请做好兜底（本入口提供网页兜底按钮）。"},{"title":"无法用链接完成购买","text":"Roblox 没有任何购买/批量购买深链，实际购买需用户在页面手动确认；批量购买仅能在体验内由服务端调用 MarketplaceService:PromptBulkPurchase（最多 20 件，仅限头像物品）。"},{"title":"OAuth 授权无法在客户端内完成","text":"授权端点在 apis.roblox.com，不在客户端 App Links 范围内，也不存在 roblox://oauth/authorize 这类深链；授权页只能在浏览器或 Custom Tab / WebView 中完成，回调可用自定义 scheme（如 myapp://callback?code=...）。"},{"title":"OAuth 明确禁止的能力","text":"好友关系的增删/邀请、代发私信或群消息、未经同意自动加入体验、代领奖励/货币、自动交易、批量登录、模拟点击/滚动/点赞/分享、为用户建立画像等均不开放。"},{"title":"launchData 与深链参数安全","text":"深链参数完全暴露在 URL 中且用户可修改，不要放入敏感信息，也不要用于鉴权。"}],"generated_at":"2026-09-12T14:53:18+00:00"}