# 新增楼盘


```
POST https://qw-openapi-tx.dustess.com/cityblock/save?accessToken=
```

**使用说明**：

当 id 字段为空，则为新增模式；当 id 字段不为空，则为更新模式。

**请求header**

| 字段         | 值               |
| ------------ | ---------------- |
| Content-Type | application/json |

**Params:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| accessToken | `String` | accessToken | true     |

**请求参数**

| 请求参数名                   | 类型      | 说明                                 | 是否必须 |
| ---------------------------- | --------- | ------------------------------------ | -------- |
| cityBlock                    | `Object`  | 楼盘                                 | true     |
| cityBlock.id                 | `String`  | 楼盘 id                              | false    |
| cityBlock.name               | `String`  | 楼盘名称                             | true     |
| cityBlock.provCity           | `String`  | 省市县编码（遵循平台省市县编码协议） | false    |
| cityBlock.addressText        | `String`  | 地址详情                             | false    |
| cityBlock.location           | `Object`  | 定位地址                             | true     |
| cityBlock.location.latitude  | `float64` | 维度                                 | true     |
| cityBlock.location.longitude | `float64` | 经度                                 | true     |
| cityBlock.creater            | `String`  | 创建员工 id                          | true     |
| cityBlock.users              | `String`  | 可用范围（遵循平台组织架构筛选协议） | false    |

**请求参数示例**
`json` - Request-Example:

```json
{
    "cityblock": {
        "id": "1234567",
        "name": "更新楼盘",
        "provCity": "110101",
        "addressText": "示例地址详情",
        "location": {
            "latitude": 116,
            "longitude": 40
        },
        "creater": "1",
        "users": "{\"employeeIds\":[],\"deptIds\":[\"1\"],\"staffListIds\":[],\"roleIds\":[],\"filterType\":\"normal\",\"includeSub\":true}"
    }
}

```

**成功响应**

| 响应参数名          | 类型     | 说明           |
| ------------------- | -------- | -------------- |
| code                | `Int`    | 响应码，0:成功 |
| msg                 | `String` | 消息提示       |
| success             | `Bool`   | 成功标识       |
| data                | `Object` | 响应结果         |
| data.id        | `String` | 创建的楼盘 id        |


**成功响应示例**

```json
{
    "success": true,
    "code": 0,
    "msg": "",
    "data": {
        "id": "1234567"
    },
    "trace_id": "81d869b0-ae7d-40e4-8d98-a14e6a941852"
}

```

**错误响应示例**

```json
{
    "success": false,
    "code": 40020,
    "msg": "param enable error ex:0|1|2",
    "data": {}
}

```