---
title: "新增通用物模型"
method: POST
path: "/api/v1/things/schema/common/create"
tags: ["things/schema/common", "thingsSchemaCommon"]
---

# 新增通用物模型

`POST /api/v1/things/schema/common/create`

## Request body

- CommonSchemaCreateReq
  - CommonSchemaInfo
    - `id` integer — 产品id
    - `type` integer — 物模型类型 1:property属性 2:event事件 3:action行为
    - `identifier` string — 标识符
    - `extendConfig` string — 拓展参数
    - `name` string — 功能名称
    - `desc` string — 描述
    - `required` integer — 是否必须 1:是 2:否
    - `affordance` string — 各功能类型的详细参数定义
    - `isCanSceneLinkage` integer — 是否可以场景联动
    - `funcGroup` integer — 功能分类: 1:普通功能 2:系统功能
    - `userPerm` integer — 用户权限操作: 1:r(只读) 3:rw(可读可写)
    - `isHistory` integer — 是否存储历史记录
    - `isPassword` integer — 是否是密码类型,密码类型需要加掩码
    - `order` integer — 排序
    - `controlMode` integer — 控制模式: 1: 可以群控,可以单控 2:只能单控

## Response `200`

A successful response.

- object
  - `code` integer
  - `msg` string

## Changes

- **2025-03-14** `e87dbcac5d9e` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/schema/common/create/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/faffe08c3de7/schema)