# Establish mqtt connection over websocket

Upgrade to WebSocket at wss://iot.hydrobit.ag/mqtt and authenticate with x-iot-token.
After upgrade, speak MQTT (v3.1.1). Use deviceId to scope topics.

Endpoint: GET /mqtt
Version: 2.0.0
Security: iotToken

## Query parameters:

  - `deviceId` (string, required)
    Device identifier to scope topics

## Response 200 fields (application/json):

  - `url` (string)
    Example: "wss://iot.hydrobit.ag/mqtt"

  - `deviceId` (string)
    Example: "bitRTU-01"

  - `topic` (string)
    MQTT topic to publish/subscribe
    Example: "connect/comp_123/proj_123/bitRTU-01/#"

  - `protocol` (string)
    Example: "MQTT v3.1.1 over WebSocket"

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"


## Response 101 fields