新增设备

POST

/api/v1/things/device/info/create

iThings-apisvr/物联网相关接口/设备/设备管理

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

iThings-token

string

可选

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzQwMzU4MDU3MDM4MTg4NTQ0IiwiZXhwIjoxNjgzNTQ4NDU5LCJpYXQiOjE2ODM1NDQ4NTksIlJvbGUiOjF9.ygQyxFx7AGtf7vcFJmE-xcElQUtwE23HN_0av02tSec

iThings-project-id

string

可选

默认值:

123123123

Body 参数application/json

productID

string

产品id

必需

不可修改

deviceName

string

设备名称

必需

不可修改

secret

string

设备秘钥

必需

cert

string

设备证书

必需

imei

string

IMEI信息

必需

mac

string

MAC信息

必需

version

string

固件版本

必需

hardInfo

string

模组硬件型号

必需

softInfo

string

模组软件版本

必需

position

object

设备定位

可选

longitude

integer

必需

latitude

integer

必需

address

string

详细地址

可选

tags

array [object {2}]

可选

key

string

必需

value

string

必需

isOnline

integer

在线状态

可选

1离线 2在线只读

firstLogin

string

激活时间

可选

lastLogin

string

最后上线时间

可选

logLevel

integer

日志级别

可选

1)关闭 2)错误 3)告警 4)信息 5)调试

createdTime

string

创建时间

可选

withProperties

object

获取的属性列表,如果不传withProperty,则不会返回

可选

key是属性id,value是{"value:"xxx","timestamp":123}的结构体,时间戳是毫秒时间戳

deviceAlias

string

设备别名

可选

projectID

string

项目id

可选

areaID

string

项目区域id

可选

示例

{
  "productID": "26gvWbvywJq",
  "deviceName": "照向上结深",
  "cert": "pariatur cupidatat",
  "imei": "ipsum aute sed",
  "mac": "est anim velit ullamco officia",
  "hardInfo": "ullamco sit ut cupidatat Ut",
  "softInfo": "incididunt in enim elit",
  "tags": [
    {
      "key": "Ut enim sint reprehenderit eu",
      "value": "dolor quis cillum"
    },
    {
      "key": "et aliquip magna do",
      "value": "deserunt laborum sit fugiat nostrud"
    },
    {
      "key": "laborum",
      "value": "sint laborum aute"
    },
    {
      "key": "laborum",
      "value": "et ut laboris aliquip anim"
    }
  ],
  "logLevel": 98,
  "address": "北京花莲县丹凤县",
  "position": {
    "longitude": 13,
    "latitude": 15
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/info/create' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "productID": "26gvWbvywJq",
    "deviceName": "照向上结深",
    "cert": "pariatur cupidatat",
    "imei": "ipsum aute sed",
    "mac": "est anim velit ullamco officia",
    "hardInfo": "ullamco sit ut cupidatat Ut",
    "softInfo": "incididunt in enim elit",
    "tags": [
        {
            "key": "Ut enim sint reprehenderit eu",
            "value": "dolor quis cillum"
        },
        {
            "key": "et aliquip magna do",
            "value": "deserunt laborum sit fugiat nostrud"
        },
        {
            "key": "laborum",
            "value": "sint laborum aute"
        },
        {
            "key": "laborum",
            "value": "et ut laboris aliquip anim"
        }
    ],
    "logLevel": 98,
    "address": "北京花莲县丹凤县",
    "position": {
        "longitude": 13,
        "latitude": 15
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer | null

返回code

必需

msg

string

返回消息

必需

默认值:

success

示例

{
  "code": 0,
  "msg": "success"
}

修改于 2023-06-18 13:44:36