跳到主要内容

DeBox App 深链接

DeBox 支持通过链接直接进入 App 内的指定页面。本页介绍代币行情页使用的自定义协议，以及群主页和个人主页使用的 HTTPS 分享链接。

1. 代币行情交易页​

使用以下格式打开 DeBox 中指定代币的行情交易页：

debox://rn/trade/token?tokenId={代币地址}-{链标识}

tokenId 由代币地址、连字符和 DeBox 支持的链标识组成。目前确认可用的链标识为 eth 和 bsc。

1.1 非原生代币​

非原生代币填写该代币在对应链上的合约地址：

debox://rn/trade/token?tokenId={代币合约地址}-bsc
debox://rn/trade/token?tokenId={代币合约地址}-eth

1.2 原生代币​

查看某条链的原生代币时，使用以下固定地址代替合约地址：

0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

示例：

debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-bsc
debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-eth

打开 Deep Link 后，用户会进入 DeBox 中对应代币的行情交易页。页面会展示价格、行情图表、交易记录、持仓地址和资金池等信息，并提供买入、卖出入口。用户可以在页面中主动进入相应的买卖流程，最终交易仍需由用户确认。Deep Link 本身只负责打开目标代币页面，不会在点击链接时自动完成交易。

DeBox ETH 行情交易页，展示价格、行情图表、交易记录以及买入和卖出入口
通过 Deep Link 打开的代币行情交易页
选择合适的接入方式

如果希望直接复用 DeBox 已有的代币行情和买卖页面，可使用行情 Deep Link；如果需要开发者自行设计合约调用、表单或其他业务流程，再使用 IM 区块链按钮或 H5/DApp。

2. 群分享链接与 gid​

DeBox 群分享链接的基础格式为：

https://m.debox.pro/group?id={gid}

链接中 id 的值就是 DeBox OpenAPI 使用的群 gid。复制出的分享链接可能还会包含 code 等其他参数；需要提取目标群的 gid 时，读取 id 即可。

在 DeBox App 中复制群分享链接：

从群聊页面打开群设置

第一步：打开群设置。

从群设置页面打开分享面板

第二步：点击分享按钮。

从群分享面板复制链接

第三步：点击“复制链接”。

3. 个人主页分享链接与 user_id​

DeBox 个人主页分享链接可以使用以下两种格式：

https://m.debox.pro/card?id={target_user_id}
https://m.debox.pro/card?id={target_user_id}&invite_code={invite_code}

同一个 DeBox 用户标识，在不同位置会使用不同的字段名：

出现位置字段名含义
DApp debox_getUserInfo 返回值uid当前用户的 DeBox 标识
OpenAPIuser_id同一个用户的 DeBox 标识
用户邀请码invite_code数值与该用户的 uid 相同
个人主页分享链接id目标主页用户的 user_id
Bot 私聊消息chat_idchat_type=private 时填写目标用户的 user_id

这些字段可以使用相同的用户标识值，但字段名和用途不能混用，调用时仍应使用接口或链接规定的字段名。个人主页链接中，id 决定打开谁的主页；invite_code 是可选的邀请码/来源参数。识别目标个人主页时，应读取 id，不能用 invite_code 代替。

在 DeBox App 中复制个人主页分享链接：

从 DeBox 个人主页打开分享面板

第一步：打开个人主页分享面板。

从 DeBox 个人主页分享页面复制链接

第二步：点击“复制链接”。

4. 使用注意事项​

  • tokenId 参数名应保持与示例完全一致。
  • 只使用当前 DeBox 客户端支持的链标识；本页示例仅采用已经确认的 eth 和 bsc。
  • 如果链接参数来自外部输入，应先校验代币地址、链标识、gid 和 user_id。
  • debox:// 链接需要在能够由 DeBox 处理该协议的设备上打开。
  • HTTPS 分享链接和 debox:// 代币链接用途不同：分享链接用于定位群或个人主页，代币链接用于打开 DeBox 行情交易页。