---
title: "获取设备物模型列表"
method: POST
path: "/api/v1/things/device/schema/index"
tags: ["things/device/schema", "thingsDeviceSchema"]
---

# 获取设备物模型列表

`POST /api/v1/things/device/schema/index`

## Request body

- DeviceSchemaIndexReq
  - `controlMode` integer — 控制模式: 1: 可以群控,可以单控 2:只能单控
  - `deviceName` string, required
  - `funcGroup` integer — 功能分类: 1:普通功能 2:系统功能
  - `identifier` string — 标识符模糊过滤
  - `identifiers` string[] — 过滤标识符列表
  - `isCanSceneLinkage` integer — 是否可以场景联动
  - `name` string
  - `page` PageInfo
    - `orders` OrderBy[] — 排序
      - `field` string — 排序的字段名
      - `sort` integer — 排序方式：1 从小到大, 2 从大到小
    - `page` integer — 页码
    - `size` integer — 每页大小
  - `productID` string, required — 产品id
  - `propertyMode` string — 属性类型可用 读写类型: 1:r(只读) 2:rw(可读可写)
  - `tag` integer — 过滤条件: 物模型标签 1:自定义 2:可选 3:必选
  - `type` integer — 物模型类型 1:property属性 2:event事件 3:action行为
  - `types` integer[]
  - `userPerm` integer — 用户权限操作: 1:r(只读) 3:rw(可读可写)
  - `withProductSchema` boolean — 同时获取产品物模型

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceSchemaIndexResp
    - `list` DeviceSchema[], required — 分页信息,只获取一个则不填
      - `affordance` string
      - `controlMode` integer — 控制模式: 1: 可以群控,可以单控 2:只能单控
      - `desc` string — 描述
      - `deviceName` string
      - `extendConfig` string — 拓展参数
      - `funcGroup` integer — 功能分类: 1:普通功能 2:系统功能
      - `identifier` string, required — 标识符
      - `isCanSceneLinkage` integer — 是否可以场景联动
      - `isPassword` integer — 是否是密码类型,密码类型需要加掩码
      - `name` string — 功能名称
      - `order` integer — 排序
      - `productID` string — 产品id 只读
      - `recordMode` integer — 1(默认) 记录历史记录 2 只记录差异值 3 不记录历史记录
      - `required` integer — 是否必须 1:是 2:否
      - `tag` integer, required — 物模型标签 1:自定义 2:可选 3:必选 必选不可删除
      - `type` integer, required — 物模型类型 1:property属性 2:event事件 3:action行为
      - `userPerm` integer — 用户权限操作: 1:r(只读) 3:rw(可读可写)
    - `page` integer — 页码
    - `pageSize` integer — 每页大小
    - `total` integer
  - `msg` string

---

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