新增设备

测试中

POST

http://prod-cn.your-api-server.com/api/open/iot-device/devicemanage/v2/device/

设备管理

最后修改时间：2024-09-19 08:15:26

责任人：李壮

新增设备并返回设备基本信息

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

Body 参数application/json

productId

string

产品编码

必需

deviceId

string

设备编码

可选

deviceName

string

设备名称

可选

description

string

设备描述

可选

authType

enum<number>

必需

认证类型 0：SECRET密钥认证，1：CERTIFICATE证书认证。
通过对每个设备进行身份验证，可以安全地将每个设备连接到平台，并且安全地管理这些设备
• 通过设备密钥进行身份验证
• 通过x.509证书进行身份验证
设备接入后平台将通过所选认证方式的认证信息对设备进行鉴权

枚举值:

fingerprint

string

可选

设备证书对应的指纹，只能为40位十六进制字符串或者64位十六进制字符串。非必填，若为空指纹设备，只验证证书是否由合法的平台上传的CA证书生成

示例

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/iot-device/devicemanage/v2/device/?project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200OK

application/json

Body

deviceId

string

设备编码

必需

deviceName

string

设备名称

必需

productId

string

产品编码

必需

productName

string

产品名称

必需

deviceSecretKey

string

设备密钥

必需

nodeType

string

节点类型

必需

direct-device:直连设备 gateway-device:网关设备 gateway-sub-device:网关子设备

onlineState

number

在线状态

必需

0:未激活 1:在线 2:离线 3:已停用

runningState

number

启停状态

必需

0:停用 1:启用

description

string

设备描述

必需

示例

{
  "deviceId": "string",
  "deviceName": "string",
  "productId": "string",
  "productName": "string",
  "deviceSecretKey": "string",
  "nodeType": "string",
  "onlineState": 0,
  "runningState": 0,
  "description": "string"
}

修改于 2024-09-19 08:15:26