新增大屏

功能介绍

新增一个大屏，大屏的内容来自模板。

URI

• URI格式

  POST /v1/{project_id}/screens

• 参数说明

  表1 URI参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目编号，获取方法请参见获取项目ID。

请求消息

响应消息

示例

创建一个名称为screen_01的大屏，使用的模板ID为32546212564。

• 请求示例

  POST https://{dlv_endpoint}/v1/{project_id}/screens
  {请求消息头}
  
  {
      "name":"screen_01",
      "alias":"test_screen_01",
      "description":"for test",
      "templateId":"32546212564",
      "workspaceId":"86ce107974ce4f93b618acb232863027"
  }

• 成功响应示例

  {
      "id": "ff80808167813a360167819d5b640045",
      "name": "screen_01",
      "alias": "test_screen_01",
      "description": "for test",
      "status": 0,
      "projectId": "abcdefghijk0123456",
      "createUser": "a1b2c2d3e4f5g6h5j6k6",
      "createDate": 1544067832676,
      "updateUser": null,
      "updateDate": null,
      "templateId": "2a8281f9678bb29f01678bb9b2d60001",
      "snapshotId": null,
      "share": null,
      "thumbnail": null,
      "config": {
          "scenes": [
              {
                  "name": "场景1",
                  "layers": [
                      {
                          "id": null,
                          "name": "层1",
                          "coms": []
                      }
                   ]
              }
          ],
          "config": {
              "id": null,
              "screenId": "ff80808167813a360167819d5b640045",
              "grid": null,
              "backgroundImage": "",
              "backgroundColor": null,
              "width": 1920,
              "height": 1080,
              "whLinkage": null,
              "comList": "",
              "screenshot": null,
              "display": 1,
              "watermarkFlag": null,
              "rulerLines": null,
              "variables": null
          }
      }
  }

• 失败响应示例

  {
      "errors": [
          {
              "error_code": "DLV.1011",
              "error_msg": "Invalid template id."
          }
      ]
  }

状态码

状态码请参见状态码。