---
title: "调用设备行为"
method: POST
path: "/api/v1/things/device/interact/action-send"
tags: ["things/device/interact", "thingsDeviceInteract"]
---

# 调用设备行为

`POST /api/v1/things/device/interact/action-send`

## Request body

- DeviceInteractSendActionReq
  - `actionID` string, required — 产品数据模板中行为功能的标识符，由开发者自行根据设备的应用场景定义
  - `deviceName` string, required — 设备名
  - `inputParams` string — 输入参数
  - `isAsync` boolean — 是否异步操作 异步情况通过获取接口来获取
  - `option` SendOption
    - `requestTimeout` integer — 请求超时,超时后会进行重试
    - `retryInterval` integer — 重试间隔
    - `timeoutToFail` integer — 超时失败时间
  - `outputParams` string — 输出参数(模拟的时候才需要填写) ,如果填写该参数,那么不会下发给设备,直接记录操作记录
  - `productID` string, required — 产品id

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceInteractSendActionResp
    - `code` integer, required — 设备返回状态码
    - `msg` string, required — 返回状态
    - `msgToken` string, required — 调用id
    - `outputParams` string, required — 输出参数 注意：此字段可能返回 null，表示取不到有效值。
  - `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)