冰梭开放平台

将冰梭的文件传输能力以标准 API 形式开放给开发者。两种能力按需选择,流量不经服务器,5 分钟完成接入。

CAPABILITIES

两种传输能力,按需选择

冰梭将传输能力抽象为两种开放形式,开发者可根据场景自主选择。

2G 内免费

P2P 直传

点对点直连传输,文件不经过任何服务器。适合实时传输、大文件快传场景。

  • 端到端直连,零中转
  • 基于 WebRTC,NAT 穿透
  • 2G 内免费,无需会员
  • 适合一次性传输
🔒
会员权益

安全中转

文件经冰梭云端加密中转存储,支持多次下载、离线接收。适合跨网、异步传输场景。

  • 云端加密存储,安全可靠
  • 支持多次下载、离线接收
  • 消耗会员流量配额
  • 适合跨网、异步传输
P2P 直传流程

P2P 直传接入流程

发送方创建任务 → 双方通过信令建立 WebRTC 连接 → 文件直传。

发送方 冰梭信令服务器 接收方 1 创建传输任务 POST /api/open/p2p/create 2 获取 ICE 配置 GET /api/open/p2p/{id}/ice-config 3 建立信令通道 WS /ws/signaling?token=xxx 信令中转 交换 SDP / ICE 候选 提供 STUN/TURN NAT 穿透辅助 4 加入信令通道 通过接收链接加入 5 交换 SDP/ICE 建立 WebRTC 连接 6 P2P 直传文件 — 端到端加密,文件不经过任何服务器 发送方 ──────── WebRTC DataChannel ────────→ 接收方
安全中转流程

安全中转接入流程

发送方上传到云端 → 生成下载链接 → 接收方异步下载。

发送方 冰梭云端 接收方 1 创建中转任务 POST /api/open/relay/create 2 上传文件 PUT uploadUrl (文件流) 3 通知上传完成 POST /{id}/complete 上传 加密存储 文件加密 · 过期自动清理 生成下载链接 可配置次数 / 有效期 链接 4 访问下载链接 GET → 302 重定向 5 下载文件 receiveToken 认证 下载 6 安全中转完成 — 文件加密存储,接收方可异步下载 发送方 ──────── 加密上传 ────────→ 冰梭云端 ──────── 加密下载 ────────→ 接收方
DOCS & RESOURCES

文档与资源

完整的 API 文档、接入案例和 SDK 下载,助您快速集成。

📖

SDK 文档

iceshuttle-js JavaScript SDK 完整接口参考,包含 P2P 直传和安全中转使用示例。

查看文档 →
🚀

在线 Demo

可直接运行的 Demo 页面,展示 P2P 直传、安全中转和文件接收的完整交互。

打开 Demo →
🔧

SDK 安装

iceshuttle-js SDK 安装指南,支持 npm 安装与 CDN 引入,5 分钟完成接入。

安装 SDK →

开始构建您的传输能力

创建应用,获取 AppKey,5 分钟完成接入。

前往创建应用