选项集
编辑选项集
根据鉴权方式查看“编辑选项集”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
optionset_id | string | 是 | 选项集ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
name | string | 是 | 选项集名称 |
options | object[] | 是 | 选项集 |
options.key | string | 是 | 选项的Key |
options.value | string | 是 | 选项值，不允许重复 |
options.index | integer | 是 | 选项排序值: 必须为整数，越小越靠前 |
options.color | string | 是 | 颜色值: colorful为true时生效，参考值 |
options.score | number | 否 | 分值，enableScore为true时生效，允许小数和正负值 |
enableColor | boolean | 是 | 启用彩色 |
enableScore | boolean | 是 | 启用分值 |
响应参数
200成功更新选项集| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | — |
curl -X PUT "https://example.com/v3/app/optionsets/optionset_id" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "name": "更新后的选项集", "options": [ { "key": "key1", "value": "更新选项1", "index": 1, "color": "#FF5722", "score": 60 } ], "enableColor": true, "enableScore": true }'{ "data": {}, "success": true}