wz-open
  1. 设备基础信息相关
wz-open
  • 接入指引
  • 设备基础信息相关
    • 汽车桩计费模式接口
      • 保存收费模式(汽车桩)
      • 获取收费模式信息(汽车桩)
    • 保存收费模式
      POST
    • 多个设备信息的返回
      POST
    • 添加设备
      POST
    • 获取免打扰设备信息
      GET
    • 获取功率模式2设置信息
      GET
    • 获取功率模式设置信息
      GET
    • 获取在线卡设置信息
      GET
    • 获取安全设置信息
      GET
    • 获取投币设置信息
      GET
    • 获取收费模式信息
      GET
    • 获取时间模式2设置信息
      GET
    • 获取时间模式设置信息
      GET
    • 获取用户设置模式信息
      GET
    • 获取电量模式2设置信息
      GET
    • 获取电量模式设置信息
      GET
    • 获取离线卡设置信息
      GET
    • 设备列表
      GET
    • 设备删除
      GET
    • 设备详情
      GET
  • 设备状态
    • 使设备重启
    • 使设备离线
    • 设置离线收益
    • 设置端口故障
    • 获取设备状态
    • 批量获取设备状态
  • 充电
    • 开始充电
    • 结束充电
  • 回调
    • ReadMe
    • 开始充电回调
    • 结束订单上报回调
    • 在线卡刷卡请求回调
    • 离线收益回调
    • 获取回调日志
    • 重新发起结束订单上报回调
  • 设备日志
    • 在线日志
  • 流量卡续费
    • ReadMe
    • 获取公司待续费列表
    • 公司创建续费订单
    • 查询公司续费状态
  1. 设备基础信息相关

保存收费模式

测试环境
https://dev-api-open.wanzhuangkj.com/
测试环境
https://dev-api-open.wanzhuangkj.com/
POST
https://dev-api-open.wanzhuangkj.com/
/open/device/saveMode
保存收费模式入参示例.txt
📌
重要修改:
电量模式和电量模式2增加新字段,work_charge_fourdigit: n毫/度,例如10000,代表1元;如需使用4位数计费,不要传work_charge,传该字段即可。计量单位毫。
时间模式返回值解析:
chargeType 设备充电类型
chargeValue 充电类型数据
maxPower 最大功率
maxPayFee 最大付款金额
startFee 起充金额
whetherRefund 是否可退款
时间模式2返回值解析:
chargeType 设备充电类型
paymentValue 每档总的金额 (单位: 分[0.01元~10元])
timeValue 每档总的时间 (单位: 秒[60秒~12小时])
maxPower 最大功率
startFee 起充金额
whetherRefund 是否可退款
电量模式返回值解析:(充电金额不能大于30元)
workCharge 电费n分/度
maxPayFee 起充金额
startFee 最大付款金额
电量模式2返回值解析:(充电金额不能大于30元)
workCharge 电费
paymentValue 每档总的金额 (单位: 分[0.01元~10元])
startFee 最大付款金额
whetherRefund 是否可退款
功率模式返回值解析:
powerValue 功率时间段
priceValue 支付金额段
checkTime 功率检测时间
incTime 结算进位时间
type 设置类型 0:基础设置 1:高级设置
countMode 功率模式计费模式
whetherRefund 是否可退款
功率模式2返回值解析:
powerValue 功率时间段
priceValue 支付金额段
checkTime 功率检测时间
incTime 结算进位时间
type 设置类型 0:基础设置 1:高级设置
countMode 功率模式计费模式
displayDelay 延迟显示时间 0表示不延迟显示,最大60s
whetherRefund 是否可退款
时间模式下只能匹配普通慢充款(0)、电量慢充款(2)、快充款(3)
时间模式2下只能匹配功率慢充款1、(功率款10)4、(电量款20)5、(两路功率款)6、(普通功率款)8
电量模式下只能匹配电量慢充款2、快充款3
电量模式2下只能匹配功率慢充款1、(功率款10)4、(电量款20)5、(两路功率款)6、(普通功率款)8
功率模式下只能匹配电量慢充款2
功率模式2下只能匹配功率慢充款1、(功率款10)4、(电量款20)5、(两路功率款)6、(普通功率款)8
汽车桩电量模式匹配 汽车交流插座桩70(12) 、 汽车慢充桩(13)

请求参数

Body 参数multipart/form-data
charge_mode
integer 
必需
充电模式: 0 时间模式; 1 电量模式; 2 功率模式; 7 时间模式2; 8 电量模式2; 9 功率模式2;
device_num
string 
设备编号
必需
charge_type
string 
必需
设备充电类型 fixed固定 custom自定义
charge_value
string 
收费类型 数组
必需
max_power
integer 
最大功率
必需
start_fee
integer 
必需
起充金额 分为单位
max_pay_fee
integer 
必需
最大金额 分为单位
payment_value
string 
可选
每档总的金额 (单位: 分[0.01元~10元])
time_value
string 
可选
每档总的时间 (单位: 秒[60秒~12小时])
work_charge
integer 
电费n分/度
可选
work_charge_fourdigit
integer 
可选
电费 四位数,比如10000代表一元/度
power_value
string 
功率时间段
可选
price_value
string 
支付金额段
可选
check_time
integer 
功率检测时间
可选
inc_time
integer 
结算进位时间
可选
type
integer 
可选
type 设置类型 0:基础设置 1:高级设置
count_mode
integer 
功率模式计费模式
可选
display_delay
string 
可选
延迟显示时间 0表示不延迟显示,最大60s
is_not_disturb
string 
必需
是否设置免打扰 0 未设置 1设置
not_disturb_start
string 
免打扰开始时间
必需
not_disturb_end
string 
免打扰结束时间
必需
not_disturb_volume
integer 
免打扰音量
必需
is_outage
integer 
必需
是否禁止断电 0 不禁止 1禁止
auto_off_wait_time
integer 
断电等待时间
必需
auto_off_lower_power
integer 
断电下限功率
必需
floating_charge_time
string 
浮充时间
必需
floating_charge_power
integer 
浮充功率
必需
whether_refund
integer 
必需
是否可退款 0 不可退款 1可退款
is_free_charge
integer 
必需
是否免费充电 0 付费充电 1免费充电
detect_time
integer 
端口预检测时间
必需
app_id
string 
应用id
可选
timestamp
integer 
请求时间戳
可选
sign
string 
签名
可选

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev-api-open.wanzhuangkj.com//open/device/saveMode' \
--form 'charge_mode=""' \
--form 'device_num=""' \
--form 'charge_type=""' \
--form 'charge_value=""' \
--form 'max_power=""' \
--form 'start_fee=""' \
--form 'max_pay_fee=""' \
--form 'payment_value=""' \
--form 'time_value=""' \
--form 'work_charge=""' \
--form 'work_charge_fourdigit=""' \
--form 'power_value=""' \
--form 'price_value=""' \
--form 'check_time=""' \
--form 'inc_time=""' \
--form 'type=""' \
--form 'count_mode=""' \
--form 'display_delay=""' \
--form 'is_not_disturb=""' \
--form 'not_disturb_start=""' \
--form 'not_disturb_end=""' \
--form 'not_disturb_volume=""' \
--form 'is_outage=""' \
--form 'auto_off_wait_time=""' \
--form 'auto_off_lower_power=""' \
--form 'floating_charge_time=""' \
--form 'floating_charge_power=""' \
--form 'whether_refund=""' \
--form 'is_free_charge=""' \
--form 'detect_time=""' \
--form 'app_id=""' \
--form 'timestamp=""' \
--form 'sign=""'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
object 
必需
result
boolean 
必需
timestamp
integer 
必需
示例
{
    "code": 1,
    "message": "SUCCESS",
    "data": {
        "result": true
    },
    "timestamp": 1636005752
}
修改于 2025-04-17 03:05:40
上一页
获取收费模式信息(汽车桩)
下一页
多个设备信息的返回
Built with