明道云开放平台

正在加载页面

鉴权方式

AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。

版本

请求地址

POST

Header 参数

名称	类型	必填	描述
`HAP-Appkey`	`string`	是	HAP应用密钥
`HAP-Sign`	`string`	是	HAP签名

Body 参数

名称	类型	必填	描述
`name`	`string`	是	选项集名称
`options`	`object[]`	是	选项集
`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`	选项集创建结果
`data.optionsetId`	`string`	选项集 ID

curl -X POST "https://example.com/v3/app/optionsets" \  -H "HAP-Appkey: {{HAP-Appkey}}" \  -H "HAP-Sign: {{HAP-Sign}}" \  -H "Content-Type: application/json" \  -d '{    "name": "状态选项集",    "options": [      {        "value": "进行中",        "index": 1,        "color": "#2196F3",        "score": 50      },      {        "value": "已完成",        "index": 2,        "color": "#4CAF50",        "score": 100      }    ],    "enableColor": true,    "enableScore": true  }'

{  "data": {    "optionsetId": "option_set_123"  },  "success": true}