保存当前用户的个性化卡片布局

用于保存当前用户的个性化卡片布局。

认证要求以参数说明为准；未标记认证的接口仍可能受到访问频率和安全策略限制。

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

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
500	`500`	An internal server error occurred.	发生内部服务器错误。
400	`400001`	A required parameter is missing.	缺少必填参数。
400	`400002`	A parameter value is invalid.	参数值无效。
401	`401002`	The API key is invalid.	API Key 无效。
403	`403003`	The IP address is blocked.	IP 地址已被拦截。
403	`403004`	The device does not belong to the current user.	该设备不属于当前用户。
403	`403005`	Permission is denied for this device or data.	无权访问该设备或数据。
429	`429004`	The request was blocked by CC attack protection.	请求被 CC 攻击防护拦截。
503	`503004`	The device permission data is not initialized.	设备权限数据尚未初始化。

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

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "key": "your_key",
    "product_id": "3",
    "card_layout": {
        "items": [
            {
                "card_id": "metric_temperature",
                "identifier": "temperature",
                "render_type": "metric",
                "title": "温度",
                "span_size": 2,
                "decimal_places": 1,
                "color_token": "primary",
                "is_enabled": true
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果