设备配网

POST

/device/provision

Device

为设备提供 MQTT 接入信息

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

配网请求参数

device_id

string

设备ID

必需

示例值:

device123

示例

{
    "device_id": "device123"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://device.qicloud.tech/api/v1/device/provision' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "device123"
}'

返回响应

🟢200成功

application/json

成功配网

Body

配网响应

code

integer

状态码

可选

示例值:

200

message

string

消息

可选

示例值:

配网成功

mqtt_host

string

MQTT 主机

可选

示例值:

localhost

mqtt_password

string

MQTT 密码

可选

示例值:

mqttpass

mqtt_port

integer

MQTT 端口

可选

示例值:

1883

mqtt_topic

string

MQTT 主题

可选

示例值:

devices/device123/status

mqtt_username

string

MQTT 用户名

可选

示例值:

mqttuser

示例

{
    "code": 200,
    "message": "配网成功",
    "mqtt_host": "localhost",
    "mqtt_password": "mqttpass",
    "mqtt_port": 1883,
    "mqtt_topic": "devices/device123/status",
    "mqtt_username": "mqttuser"
}

🟠400请求有误

🔴500服务器错误