车位管理

API列表

请求方式	API	描述
POST	/v1.0/iot-02/third/parking/parking-spots	添加车位
PUT	/v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}	修改车位
DELETE	/v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}	删除车位
GET	/v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}	车位详情
GET	/v1.0/iot-02/third/parking/parking-spots	查询车位

添加车位

功能描述

添加车位

接口地址

POST /v1.0/iot-02/third/parking/parking-spots

请求参数

参数名	类型	参数类型	说明	是否必需
parking_lot_id	String	body	车场 id	true
name	String	body	车位名，不超过 100 个字符	true
type	String	body	车位性质，(fixed_spot:固定车位；vip_spot:vip 车位；virtual_spot:虚拟车位；ownership_spot:产权车位；pooling_spot:公摊车位；other_spot:其他车位)	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	车位 id

请求示例

POST /v1.0/iot-02/third/parking/parking-spots
{
  "parking_lot_id": "ljn1COV9X7",
  "name": "I72W5ZzTsL",
  "type": "fixed_spot"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": "rdfzKnMlle"
}

修改车位

功能描述

修改车位

接口地址

PUT /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}

请求参数

参数名	类型	参数类型	说明	是否必需
parking_spot_id	String	url	车位 id	true
name	String	body	车位名，不超过 100 个字符	true
type	String	body	车位性质，(fixed_spot:固定车位；vip_spot:vip 车位；virtual_spot:虚拟车位；ownership_spot:产权车位；pooling_spot:公摊车位；other_spot:其他车位)	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

PUT /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}
{
  "name": "ToNn3WjgmJ",
  "type": "fixed_spot"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": false
}

删除车位

功能描述

删除车位

接口地址

DELETE /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}

请求参数

参数名	类型	参数类型	说明	是否必需
parking_spot_id	String	url	车位 id	true
parking_spot_id	String	query	车位 id	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

DELETE /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}?parking_spot_id=ygmWu4QRq0

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": true
}

车位详情

功能描述

车位详情

接口地址

GET /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}

请求参数

参数名	类型	参数类型	说明	是否必需
parking_spot_id	String	url	车位 id	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	车位信息

result 参数说明

参数名	类型	说明
project_id	String	项目 id
creator	String	创建者
modifier	String	修改者
gmt_create	long	创建时间（毫秒）
gmt_modified	long	修改时间（毫秒）
parking_spot_id	String	车位 id
name	String	车位名
type	String	车位性质
parking_lot_id	String	车场 id

请求示例

GET /v1.0/iot-02/third/parking/parking-spots/{parking_spot_id}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "project_id": "16O5VpcgKG",
    "creator": "qLFOyQDB8M",
    "modifier": "WdTf0U8iGJ",
    "gmt_create": 109123,
    "gmt_modified": 705087,
    "parking_spot_id": "AJLXIIXLMz",
    "name": "i58s4ZbWhy",
    "type": "Ok1NKlX0dn",
    "parking_lot_id": "U29YBYs4R2"
  }
}

查询车位

功能描述

查询车位

接口地址

GET /v1.0/iot-02/third/parking/parking-spots

请求参数

参数名	类型	参数类型	说明	是否必需
page_no	int	query	页码，最小值 1	false
page_size	int	query	页大小，最小值 1，最大值 1000	false
parking_lot_id	String	query	车场 id	true
parking_spot_id	String	query	车位 ID	false
name	String	query	车位名（模糊搜索）	false
type	String	query	车位性质，(fixed_spot:固定车位；vip_spot:vip 车位；virtual_spot:虚拟车位；ownership_spot:产权车位；pooling_spot:公摊车位；other_spot:其他车位)	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	车位信息分页列表

result 参数说明

参数名	类型	说明
total	int	总数
data	Object[]	当前页数据
- project_id	String	项目 id
- creator	String	创建者
- modifier	String	修改者
- gmt_create	long	创建时间（毫秒）
- gmt_modified	long	修改时间（毫秒）
- parking_spot_id	String	车位 id
- name	String	车位名
- type	String	车位性质
- parking_lot_id	String	车场 id

请求示例

GET /v1.0/iot-02/third/parking/parking-spots?page_no=1&page_size=100&parking_lot_id=CaaTM0xRcX&parking_spot_id=Eox4ILNDv5&name=53jf32PCgH&type=fixed_spot

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "total": 1,
    "data": [
      {
        "project_id": "DKsyFASMOa",
        "creator": "eUqav2ThGZ",
        "modifier": "1ksygIWzsA",
        "gmt_create": 732871,
        "gmt_modified": 960473,
        "parking_spot_id": "LDz5Shodtz",
        "name": "VTTDEIeBj9",
        "type": "WgYgShrORT",
        "parking_lot_id": "w3rcsmxfvO"
      }
    ]
  }
}