新增接待区域

POST

/openapi/reception/area

新增一个接待区域。单位账号会自动归属到当前单位；园区账号必须传入 company_id，且该单位必须属于当前园区。

device_ids 为可选参数：传入时会同步保存该区域绑定的设备；不传则只创建区域，不调整设备绑定。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "name": "办公区",
    "company_id": 1,
    "third_party_unique_id": "area-office",
    "is_default": true,
    "device_ids": [
        30,
        31
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/reception/area?access_token=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "name": "办公区",
    "company_id": 1,
    "third_party_unique_id": "area-office",
    "is_default": true,
    "device_ids": [
        30,
        31
    ]
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "id": 12,
        "name": "办公区",
        "company_id": 1,
        "company_name": "测试单位",
        "park_id": 1,
        "park_name": "测试园区",
        "third_party_unique_id": "area-office",
        "is_default": true
    }
}

修改于 2026-07-09 15:37:45

查询接待区域列表

修改接待区域