帮助文档

创建空间（楼层）

POST

https://api.maxhub.com/maxhub-blu/api/open/v5/space/layer

请求参数

Header 参数

X-Isp-Code

string

必需

组织码，获取路径：领效星云管理页面-> 我的企业 -> 企业ID

示例值:

Authorization

string

客户端令牌

必需

示例值:

Bearer {{sign_client_token}}

X-Isp-TraceId

string

必需

请求ID, 随机生成的32位uuid

示例值:

X-Auth-Sign

string

必需

签名，规则参考参数验签生成规则

示例值:

X-Auth-Timestamp

string

必需

请求发送的毫秒时间戳

示例值:

Body 参数application/json

spaceName

string

外部ID

必需

thirdPartyId

string

第三方id

可选

spaceCapacity

number

空间容量

可选

spaceAddress

string

空间详细地址

可选

lastSpaceId

number

可选

同层级空间列表中上一个空间id 如果不传就自动换取放在兄弟列表的最后

thirdPartyType

string

第三方类型

可选

parentId

number

可选

父级楼层ID，不传默认为根目录

示例

{
  "spaceName": "花明切己",
  "thirdPartyId": "59",
  "spaceCapacity": 35,
  "spaceAddress": "河南省毕节市万盛区",
  "thirdPartyType": "huaxing",
  "parentId": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.maxhub.com/maxhub-blu/api/open/v5/space/layer' \
--header 'X-Isp-Code: {{sign_orgCode}}' \
--header 'Authorization: Bearer {{sign_client_token}}' \
--header 'X-Isp-TraceId: {{uuid}}' \
--header 'X-Auth-Sign: {{sign}}' \
--header 'X-Auth-Timestamp: {{timestamp}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spaceName": "花明切己",
    "thirdPartyId": "59",
    "spaceCapacity": 35,
    "spaceAddress": "河南省毕节市万盛区",
    "thirdPartyType": "huaxing",
    "parentId": 0
}'

返回响应

🟢200成功

application/json

Body

code

number

返回码

必需

data

object

返回数据

必需

spaceName

string

空间名称

必需

spaceCapacity

string

空间容量

可选

spaceAddress

string

空间地址

可选

spaceCategoryCode

string

空间门类编码

可选

spaceType

string

空间类型

可选

spaceAvailabilityStatus

string

空间可用状态

可选

spaceCategoryName

string

空间分类名称

可选

prevId

number

前一个节点id

必需

number

主键

必需

parentId

number

父级楼层ID

必需

siblingId

number

后一个节点id

必需

message

string

返回信息

必需

示例

{
  "code": 200,
  "data": {
    "spaceAddress": "河南省毕节市万盛区",
    "thirdPartyType": "huaxing",
    "spaceType": "SPACE",
    "parentId": "0",
    "spaceName": "花明切己",
    "thirdPartyId": "59",
    "spaceCapacity": 35,
    "orgCode": "790320193",
    "prevId": "0",
    "id": "1871025633484255233",
    "siblingId": "0"
  },
  "success": true,
  "failure": false,
  "message": "OK"
}

修改于 2024-12-24 12:36:14

分页查询空间

创建空间