调用设备行为

POST

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

iThings-token

string

可选

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzQwMzU4MDU3MDM4MTg4NTQ0IiwiZXhwIjoxNjgzNTQ4NDU5LCJpYXQiOjE2ODM1NDQ4NTksIlJvbGUiOjF9.ygQyxFx7AGtf7vcFJmE-xcElQUtwE23HN_0av02tSec

iThings-project-id

string

可选

默认值:

123123123

Body 参数application/json

productID

string

产品id

必需

deviceName

string

设备名

必需

actionID

string

产品数据模板中行为功能的标识符

必需

由开发者自行根据设备的应用场景定义

inputParams

string

输入参数

必需

isAsync

boolean

是否异步操作

可选

异步情况通过获取接口来获取

示例

{
    "productID": "string",
    "deviceName": "string",
    "actionID": "string",
    "inputParams": "string",
    "isAsync": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/interact/send-action' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "productID": "string",
    "deviceName": "string",
    "actionID": "string",
    "inputParams": "string",
    "isAsync": true
}'

返回响应

🟢200成功

application/json

Body

code

integer | null

返回code

必需

msg

string

返回消息

必需

默认值:

success

data

object

调用id

必需

clientToken

string

必需

outputParams

string | null

输出参数

必需

注意：此字段可能返回 null，表示取不到有效值。

status

string

返回状态

必需

code

string

设备返回状态码

必需

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "clientToken": "string",
        "outputParams": "string",
        "status": "string",
        "code": "string"
    }
}

修改于 2023-06-18 13:44:36