WringCloud Open Platform

Expose WringCloud's file transfer capabilities to developers through standard APIs. Choose between two capabilities on demand — data never touches a server, and integration takes just 5 minutes.

CAPABILITIES

Two Transfer Capabilities, Choose as Needed

WringCloud abstracts its transfer capabilities into two open forms, letting developers choose freely by scenario.

Free up to 2GB

P2P Direct Transfer

Peer-to-peer direct transfer — files never touch any server. Ideal for real-time transfer and fast large-file delivery.

  • End-to-end direct connection, zero relay
  • WebRTC-based with NAT traversal
  • Free up to 2GB, no plan required
  • Ideal for one-off transfers
🔒
Plan Benefit

Secure Relay

Files are encrypted and stored via WringCloud cloud relay, supporting multiple downloads and offline receiving. Ideal for cross-network, asynchronous transfer.

  • Encrypted cloud storage, secure and reliable
  • Multiple downloads and offline receiving
  • Consumes plan credit quota
  • Ideal for cross-network, asynchronous transfer
P2P Direct Transfer Flow

P2P Direct Transfer Integration Flow

Sender creates a task → both sides establish a WebRTC connection via signaling → files transfer directly.

Sender WringCloud Signaling Server Receiver 1 Create Transfer Task POST /api/open/p2p/create 2 Get ICE Config GET /api/open/p2p/{id}/ice-config 3 Open Signaling Channel WS /ws/signaling?token=xxx Signaling Relay Exchange SDP / ICE candidates Provides STUN/TURN NAT traversal assistance 4 Join Signaling Channel Join via the receive link 5 Exchange SDP/ICE Establish WebRTC connection 6 P2P Direct Transfer — end-to-end encrypted, files never touch any server Sender ──────── WebRTC DataChannel ────────→ Receiver
Secure Relay Flow

Secure Relay Integration Flow

Sender uploads to the cloud → a download link is generated → receiver downloads asynchronously.

Sender WringCloud Cloud Receiver 1 Create Relay Task POST /api/open/relay/create 2 Upload File PUT uploadUrl (file stream) 3 Notify Upload Complete POST /{id}/complete Upload Encrypted Storage Encrypted files · auto-purged on expiry Generate Download Link Configurable count / validity Link 4 Access Download Link GET → 302 redirect 5 Download File receiveToken auth Download 6 Secure Relay complete — files stored encrypted, receivers download asynchronously Sender ──────── Encrypted upload ────────→ WringCloud Cloud ──────── Encrypted download ────────→ Receiver
DOCS & RESOURCES

Docs & Resources

Complete API documentation, integration examples and SDK downloads to help you integrate quickly.

📖

SDK Documentation

Complete API reference for the iceshuttle-js JavaScript SDK, with usage examples for both P2P direct transfer and secure relay.

View Docs →
🚀

Online Demo

A runnable demo page showcasing the full interactions of P2P direct transfer, secure relay and file receiving.

Open Demo →
🔧

SDK Installation

Installation guide for the iceshuttle-js SDK, supporting npm install and CDN inclusion — integrate in 5 minutes.

Install SDK →

Start Building Your Transfer Capability

Create an app, get your AppKey, and integrate in 5 minutes.

Create an App Now