新增通用物模型

POST

/api/v1/things/schema/common/create

请求参数

Header 参数

Ithings-Project-Id

string

可选

默认值:

Ithings-Token

string

可选

默认值:

app-code

string

可选

默认值:

device-id

string

可选

用户正在使用的设备ID(小程序,ios,安卓的设备ID)

Body 参数application/json

object (CommonSchemaInfo)

可选

integer <int64>

产品id

可选

type

integer <int64>

可选

物模型类型 1:property属性 2:event事件 3:action行为

identifier

string

标识符

可选

extendConfig

string

拓展参数

可选

name

string

功能名称

可选

desc

string

描述

可选

required

integer <int64>

可选

是否必须 1:是 2:否

affordance

string

可选

各功能类型的详细参数定义

isCanSceneLinkage

integer <int64>

是否可以场景联动

可选

funcGroup

integer <int64>

可选

功能分类: 1:普通功能 2:系统功能

userPerm

integer <int64>

可选

用户权限操作: 1:r(只读) 3:rw(可读可写)

isHistory

integer <int64>

是否存储历史记录

可选

isPassword

integer <int64>

可选

是否是密码类型,密码类型需要加掩码

order

integer <int64>

排序

可选

controlMode

integer <int64>

可选

控制模式: 1: 可以群控,可以单控 2:只能单控

示例

{
    "": {
        "id": 0,
        "type": 0,
        "identifier": "string",
        "extendConfig": "string",
        "name": "string",
        "desc": "string",
        "required": 0,
        "affordance": "string",
        "isCanSceneLinkage": 0,
        "funcGroup": 0,
        "userPerm": 0,
        "isHistory": 0,
        "isPassword": 0,
        "order": 0,
        "controlMode": 0
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/things/schema/common/create' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "": {
        "id": 0,
        "type": 0,
        "identifier": "string",
        "extendConfig": "string",
        "name": "string",
        "desc": "string",
        "required": 0,
        "affordance": "string",
        "isCanSceneLinkage": 0,
        "funcGroup": 0,
        "userPerm": 0,
        "isHistory": 0,
        "isPassword": 0,
        "order": 0,
        "controlMode": 0
    }
}'

返回响应

🟢200成功

application/json

A successful response.

Body

code

integer

返回code

可选

默认值:

200

msg

string

返回的消息

可选

示例

{
    "code": "200",
    "msg": "string"
}

修改于 2025-07-05 02:25:32

执行规则链

删除通用物模型