---
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
  - `productID` string, required — 产品id
  - `deviceName` string, required — 设备名
  - `actionID` string, required — 产品数据模板中行为功能的标识符，由开发者自行根据设备的应用场景定义
  - `inputParams` string — 输入参数
  - `isAsync` boolean — 是否异步操作 异步情况通过获取接口来获取
  - `option` SendOption
    - `timeoutToFail` integer — 超时失败时间
    - `requestTimeout` integer — 请求超时,超时后会进行重试
    - `retryInterval` integer — 重试间隔

## Response `200`

A successful response.

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

## 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/device/interact/action-send/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/65bf12e56421/schema)