---
name: "addCommandToCache"
mode: "kit"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
---

## addCommandToCache

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.5

> 💡 接口依赖云能力，需在 [小程序开发者平台](https://platform.tuya.com/miniapp/) 开发设置 - 云能力 进行授权配置。

### 描述

将指令（DP 键值对的 JSON 字符串）添加到云端缓存，以便后续下发给指定设备。支持 Wi-Fi、ZigBee 设备。

### 参数

`Params`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `params` | `AddCommandToCacheParams` | 是 | - | 请求体 |

### 引用对象

##### `interface` AddCommandToCacheParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `dps` | `string` | DP 键值对的 JSON 字符串 |
| `time` | `number` | 指令下发时的时间戳，单位：毫秒 |


### 示例代码

#### 请求示例

```typescript
import { addCommandToCache } from '@tuya-miniapp/cloud-api';

const result = await addCommandToCache({
  devId: 'your_device_id',
  dps: JSON.stringify({
    switch_1: true,
  }),
  time: Date.now(),
});
```

#### 返回示例

```json
true
```