设备动态认证（一型一密）

测试中

本地

http://127.0.0.1:9999

POST

/api/v1/device/auth

支持两种认证流程：
1.仅使用模板密钥的认证流程：设备仅关联到设备模板
2.使用模板密钥+ProductKey的认证流程：设备关联到特定产品

请求参数

Header 参数

x-token

string

可选

默认值:

Body 参数application/json

template_secret

string

模板密钥

必需

device_number

string

设备唯一标识

必需

device_name

string

设备名称

可选

product_key

string

产品密钥

可选

可选，用于产品关联

parent_device_number

string

父设备编号

可选

设备为子设备时必输

sub_device_addr

string

子设备地址

可选

设备为子设备时必输

示例

{
    "template_secret": "string",
    "device_number": "string",
    "device_name": "string",
    "product_key": "string",
    "parent_device_number": "string",
    "sub_device_addr": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:9999/api/v1/device/auth' \
--header 'x-token: {{x-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "template_secret": "string",
    "device_number": "string",
    "device_name": "string",
    "product_key": "string",
    "parent_device_number": "string",
    "sub_device_addr": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

device_id

string

必需

voucher

string

必需

示例

{"code":200,"message":"操作成功","data":{"device_id":"4e7e16dc-b1e7-5eef-32a6-48a7d767c85f","voucher":"{\"username\":\"6c2f1bdc-6fc2-b535-f0ba-f77fe9dc6db1\"}"}}

修改于 2025-06-07 06:40:12