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

测试中

本地

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

产品密钥

可选

可选，用于产品关联

示例

{
  "template_secret": "string",
  "device_number": "string",
  "device_name": "string",
  "product_key": "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"
}'

返回响应

🟢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-05-06 13:47:02