目录

创建空间

  1. 描述:调用此接口创建空间信息,在酒店行业是客房;教育行业是教室;医疗行业是病床/病房;企业单位是会议室、办公区等。

    注:一个项目支持创建1000个空间信息。

  2. 接口类型:REST
  3. URI:

    请求方法

    POST

    URI

    /openapi/asset/v1/space

    传输协议

    HTTPS

  4. 请求参数:

    序号

    参数

    是否必须

    类型

    长度

    描述

    1

    spaceName

    必选

    String

    1-256

    空间名

    2

    desc

    可选

    String

    1-256

    描述信息

  5. 响应参数:

    序号

    参数

    是否必须

    类型

    长度

    描述

    1

    spaceId

    必选

    String

    1-24

    唯一的ID

  6. 请求示例:
    POST https://{Endpoint}/openapi/asset/v1/space
     
    {
    "spaceName": "8601",
    "desc": "客房"
    }
     
  7. 响应示例:

    Status Code: 201 Created

    {
    "spaceId": "1233478845322"
    }
  8. 错误码

HTTP状态码

错误码

英文错误描述

中文错误描述

处理建议

400

space.001000

Bad Request.

请求的格式不正确,如json非法,mediaType不正确等。

请排查该请求的请求格式是否正确。

space.001001

Space name invalid.

空间命名不合法

请修改空间命名

space.001002

Space name repeat in a project.

同一个项目下,不允许重复命名

请修改空间命名

space.001003

Space

count exceeds.

空间数量超过限额

不允许超过1000个

401

common.000001

Unauthorized.

非法请求

请检查AK/SK算法是否正确。

403

common.000002

Forbidden.

没有权限

请检查是否被授权

404

common.000003

Not Found.

资源不存在

请排查请求参数是否有误

500

common.000004

Internal server error.

内部错误

请稍等重试

503

Common.000005

Limit access.

限制访问

请联系华为工程师分析解决。

590