月卡收费规则管理

更新时间：2025-05-30 01:56:03下载pdf

API列表

请求方式	API	描述
POST	/v1.0/iot-02/third/parking/charge-rules	创建月卡收费规则
PUT	/v1.0/iot-02/third/parking/charge-rules/{rule_id}	修改月卡收费规则
DELETE	/v1.0/iot-02/third/parking/charge-rules/{rule_id}	删除月卡收费规则
GET	/v1.0/iot-02/third/parking/charge-rules/{rule_id}	月卡收费规则 id 查询
PUT	/v1.0/iot-02/third/parking/charge-rules/{rule_id}/status	启用禁用收费规则
GET	/v1.0/iot-02/third/parking/charge-rules	条件查询：支持分页
GET	/v1.0/iot-02/third/parking/charge-rules/any	查询任意收费规则：删除也能查

创建月卡收费规则

功能描述

创建月卡收费规则

接口地址

POST /v1.0/iot-02/third/parking/charge-rules

请求参数

参数名	类型	参数类型	说明	是否必需
rule_name	String	body	收费规则名称，不超过 100 个字符	true
price	long	body	单价：分	true
unit	String	body	单位：年，季度，月，(month:月；quarter:季度；year:年)	true
remark	String	body	备注	false

返回参数

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

请求示例

POST /v1.0/iot-02/third/parking/charge-rules
{
  "rule_name": "Hizb7RAX4F",
  "price": 318381,
  "unit": "month",
  "remark": "3oTwSbGpNR"
}

响应示例

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

修改月卡收费规则

功能描述

修改月卡收费规则

接口地址

PUT /v1.0/iot-02/third/parking/charge-rules/{rule_id}

请求参数

参数名	类型	参数类型	说明	是否必需
rule_id	String	url	规则 id	true
rule_name	String	body	收费规则名称，不超过 100 个字符	true
price	long	body	单价	true
unit	String	body	单位：年，季度，月，(month:月；quarter:季度；year:年)	true
remark	String	body	备注	false

返回参数

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

请求示例

PUT /v1.0/iot-02/third/parking/charge-rules/{rule_id}
{
  "rule_name": "FKxBtCEtWG",
  "price": 107115,
  "unit": "month",
  "remark": "X2RV2UFnmY"
}

响应示例

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

删除月卡收费规则

功能描述

删除月卡收费规则

接口地址

DELETE /v1.0/iot-02/third/parking/charge-rules/{rule_id}

请求参数

参数名	类型	参数类型	说明	是否必需
rule_id	String	url	规则 id	true
rule_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/charge-rules/{rule_id}?rule_id=FhWp6VoqFz

响应示例

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

月卡收费规则 id 查询

功能描述

月卡收费规则id查询

接口地址

GET /v1.0/iot-02/third/parking/charge-rules/{rule_id}

请求参数

参数名	类型	参数类型	说明	是否必需
rule_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	修改时间（毫秒）
rule_id	String	收费规则 id
rule_num	String	规则编号
rule_name	String	收费规则名称
price	long	单价
unit	String	单位：，季度，月
remark	String	备注
rule_status	String	收费规则状态

请求示例

GET /v1.0/iot-02/third/parking/charge-rules/{rule_id}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "project_id": "CqgCKdi8HY",
    "creator": "zuxEWplBOC",
    "modifier": "l028BGDz8f",
    "gmt_create": 511436,
    "gmt_modified": 964190,
    "rule_id": "Cwe4IOBbPv",
    "rule_num": "Z6LoyCoG4A",
    "rule_name": "sMmrJjDtuY",
    "price": 826741,
    "unit": "年",
    "remark": "jTnD92ZdsU",
    "rule_status": "sPc8VDyRLU"
  }
}

启用禁用收费规则

功能描述

启用禁用收费规则

接口地址

PUT /v1.0/iot-02/third/parking/charge-rules/{rule_id}/status

请求参数

参数名	类型	参数类型	说明	是否必需
rule_id	String	url	规则 id	true
rule_id	String	query	收费规则 id	true
rule_status	String	query	启用禁用状态，(enable:启用状态；disable:禁用状态)	true

返回参数

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

请求示例

PUT /v1.0/iot-02/third/parking/charge-rules/{rule_id}/status?rule_id=xWYuouw4fS&rule_status=enable

响应示例

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

条件查询：支持分页

功能描述

条件查询：支持分页

接口地址

GET /v1.0/iot-02/third/parking/charge-rules

请求参数

参数名	类型	参数类型	说明	是否必需
page_no	int	query	页码，最小值 1	false
page_size	int	query	页大小，最小值 1，最大值 1000	false
rule_name	String	query	收费规则名称	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	修改时间（毫秒）
rule_id	String	收费规则 id
rule_num	String	规则编号
rule_name	String	收费规则名称
price	long	单价
unit	String	单位：，季度，月
remark	String	备注
rule_status	String	收费规则状态

请求示例

GET /v1.0/iot-02/third/parking/charge-rules?page_no=1&page_size=100&rule_name=65iNRRnR0f

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "total": 1,
    "data": [
      {
        "project_id": "HBPbn0Csd5",
        "creator": "ymgLai0xav",
        "modifier": "BtWrHyKWBe",
        "gmt_create": 115045,
        "gmt_modified": 815598,
        "rule_id": "CmeDi8LErg",
        "rule_num": "57BUdyLaDL",
        "rule_name": "XuIMlG1C7d",
        "price": 721003,
        "unit": "年",
        "remark": "z86vA9SFav",
        "rule_status": "Bek7FQthlc"
      }
    ]
  }
}

查询任意收费规则：删除也能查

功能描述

查询任意收费规则：删除也能查

接口地址

GET /v1.0/iot-02/third/parking/charge-rules/any

请求参数

参数名	类型	参数类型	说明	是否必需
rule_id	String	query	收费规则 id	false

返回参数

参数名	类型	说明
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	修改时间（毫秒）
rule_id	String	收费规则 id
rule_num	String	规则编号
rule_name	String	收费规则名称
price	long	单价
unit	String	单位：，季度，月
remark	String	备注
rule_status	String	收费规则状态

请求示例

GET /v1.0/iot-02/third/parking/charge-rules/any?rule_id=KDHu6iTI3C

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": [
    {
      "project_id": "MVgszMKqf2",
      "creator": "SsQQSdw28A",
      "modifier": "ED38WZGl2I",
      "gmt_create": 775558,
      "gmt_modified": 875036,
      "rule_id": "oY8BWexxSl",
      "rule_num": "iPlz18ZdAP",
      "rule_name": "VuAq9ZXegF",
      "price": 734393,
      "unit": "年",
      "remark": "yVMtI4AMDY",
      "rule_status": "rA8UGfsDbR"
    }
  ]
}

上一篇车组管理

下一篇月卡管理