Device Side

Request Method	POST
URI	/v5/iot/tunnels/{tunnel_id}/device-connect
Transport Protocol	wss (Sec-Websocket)

Parameter	Mandatory	Type	Location	Description
tunnel_access_token	Yes	String	Header	Explanation: Device access tunnel token, which is delivered by the platform through the MQTT topic when a device tunnel is created. Value range: 1 to 256 characters.
tunnel_id	Yes	String	Path	Explanation: Tunnel ID, which uniquely identifies a tunnel. Value range: No more than 128 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

Parameter

Mandatory

Type

Location

Description

tunnel_access_token

Yes

String

Header

Explanation: Device access tunnel token, which is delivered by the platform through the MQTT topic when a device tunnel is created.

Value range: 1 to 256 characters.

tunnel_id

Yes

String

Path

Explanation: Tunnel ID, which uniquely identifies a tunnel.

Value range: No more than 128 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

POST wss://{endpoint}/v5/iot/tunnels/{tunnel_id}/device-connect

Status Code: 200 Access success

Parent topic: Establishing a WebSocket Connection over a Secure Tunnel