---
title: "获取设备影子列表"
method: POST
path: "/api/v1/things/device/msg/shadow/index"
tags: ["things/device/msg", "thingsDeviceMsg"]
---

# 获取设备影子列表

`POST /api/v1/things/device/msg/shadow/index`

## Request body

- DeviceMsgPropertyLatestIndexReq
  - `dataIDs` string[] — 获取的具体标识符的数据 如果不指定则获取所有属性数据,一个属性一条,如果没有获取到的不会返回值
  - `deviceName` string — 设备名
  - `ignoreEmpty` boolean — 设备属性是否忽略空值,空值是否返回
  - `productID` string — 产品id 获取产品id下的所有设备信息

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceMsgShadowIndexResp
    - `list` DeviceMsgShadowIndex[], required
      - `dataID` string, required — 属性id
      - `updatedDeviceTime` integer, required — 更新到设备的时间
      - `value` string, required — 获取到的值
  - `msg` string

## Changes

- **2026-03-27** `b9582d0ab6af` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **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/device/msg/shadow/index/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/f3bdeb916389/schema)