执行展示控制卡片

用于执行展示控制卡片。

需要认证：在查询参数 key 或请求体 api_key 中传入用户 API Key；要求会话的接口还需传入 session_token。

请求可使用 JSON（Content-Type: application/json）或表单编码；字段含义、必填性和示例以本接口定义为准。

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
400	`400001`	A required parameter is missing.	缺少必填参数。
401	`401002`	The API key is invalid.	API Key 无效。
403	`403004`	The device does not belong to the current user.	该设备不属于当前用户。
403	`403005`	Permission is denied for this device or data.	无权访问该设备或数据。
403	`403006`	Permission is denied for this AI model.	无权使用该 AI 模型。
404	`404001`	The user was not found.	用户不存在。
405	`405001`	The HTTP method is not supported for this operation.	该操作不支持当前 HTTP 方法。
422	`422001`	The request body failed validation.	请求体校验失败。
422	`422002`	The property value is outside the allowed range.	属性值超出允许范围。
422	`422003`	The property value does not match the required format.	属性值不符合要求的格式。
422	`422004`	The property value does not match the configured step.	属性值不符合配置步长。
500	`500003`	The AI prediction failed.	AI 预测失败。

所有响应均包含 request_id，排查问题时请一并提供该值。

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

key: ********************

Query 参数

Body 参数application/json必填

示例

{
    "api_key": "string",
    "product_id": "string",
    "device_secret": "string",
    "card_id": "string",
    "operation_id": "string",
    "value": "string",
    "property1": "string",
    "property2": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟠400

application/json

Possible error codes: 400001.

Bodyapplication/json

示例

{
    "success": false,
    "errno": 400001,
    "message": "A required parameter is missing.",
    "error": "A required parameter is missing.",
    "message_zh": "缺少必填参数。",
    "request_id": "req_0123456789abcdef0123456789abcdef"
}

🟠401

🟠403

🟠404

🟠405

🟠422

🔴500

🟢200Success

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果