应用
批量创建应用项
批量创建空白应用项(自定义页面或工作表)。
鉴权方式
AppKey + Sign 是应用密钥鉴权,由管理员创建,用于以应用管理员身份访问应用数据。
版本
请求地址
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
items | object[] | 是 | 要创建的应用项列表 |
items.type | string | 是 | 应用项类型。必填值:'worksheet'(工作表) 或 'customPage'(自定义页面) 可选值: "worksheet""customPage" |
items.icon | string | 否 | 图标名称,例如:'8_4_folder' |
items.name | string | 是 | 应用项的名称,例如:'仪表盘' 或 '基础资料' |
items.remark | string | 否 | 备注说明 |
items.sectionId | string | 否 | 所属分组 ID。可选;如果不传则默认放到第一个分组中(没有分组时表示默认分组)。 |
响应参数
200成功创建应用项分组| 名称 | 类型 | 描述 |
|---|---|---|
data | object[] | — |
data.id | string | 应用项id |
data.type | string | — |
data.name | string | — |
data.sectionId | string | — |
success | boolean | — |
error_code | integer | — |
curl -X POST "https://example.com/v3/app/items/batch" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "type": "worksheet", "name": "工作表", "remark": "工作表备注" }, { "type": "customPage", "name": "自定义页面", "remark": "页面备注" } ] }'{ "success": true, "error_code": 1, "data": { "sectionIds": [ "676910ae3e6f2583f5d3edd5" ] }}