autumn/jsowell-charger-web
1
0
Fork 0
mirror of https://codeup.aliyun.com/67c68d4e484ca2f0a13ac3c1/ydc/jsowell-charger-web.git synced 2026-04-19 18:45:03 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
397ba75479cb5804b01cc86055ecd9797da7dba7
jsowell-charger-web/doc/接口文档New.md
JSOWELL-PC\autum 397ba75479 commit
2023-03-04 16:29:55 +08:00

22 KiB
Raw Blame History

小程序接口

接口返回格式

字段名 类型 是否必传 备注
resCode String Y 返回码
msg String Y 返回信息
obj Object Y 返回的数据

以下接口反参，指的是obj中的数据，接口返回都有resCode，msg，obj这三个字段。

示例

# 入参
{
    "pageSize": "10",
    "pageNum": "1",
    "stationLng": "55.96",
    "stationLat": "155.77"
}

# 反参
{
    "resCode": "00100000",
    "msg": "操作成功",
    "obj": {
        "pageNum": 1,
        "pageSize": 10,
        "list": [
            {
                "stationId": "2",
                "stationName": "测试仓库",
                "stationAddress": "华新镇华隆路1777号6幢D座",
                "distance": "10745.74",
                "electricityPrice": null,
                "servicePrice": null,
                "fastTotal": 0,
                "fastFree": 0,
                "slowTotal": 3,
                "slowFree": 0
            },
            {
                "stationId": "1",
                "stationName": "测试",
                "stationAddress": "黄埔江南路278号举视新能源",
                "distance": "10762.94",
                "electricityPrice": null,
                "servicePrice": null,
                "fastTotal": 0,
                "fastFree": 0,
                "slowTotal": 0,
                "slowFree": 0
            }
        ],
        "total": 2,
        "pages": 1
    }
}

# 错误反参
{
    "resCode": "00100010",
    "msg": "查询充电站信息列表异常",
    "obj": null
}

1001 登录注册接口

1002 查询会员信息

接口地址：http://localhost:8080/uniapp/member/getMemberInfo

请求方式：GET

入参

null，在Header中需传Authorization

反参

字段名 类型 是否必传 备注
MemberVO Object Y 用户信息对象

MemberVO

字段名 类型 是否必传 备注
memberId String Y 会员Id
status String Y 状态(1-正常;0-停用)
nickName String Y 用户昵称
mobileNumber String Y 手机号码
principalPrice Number Y 本金金额
giftPrice Number Y 赠送金额
totalAccountAmount Number Y 总金额(本金金额 + 赠送金额)

1003 修改会员信息

2001 根据经纬度查询充电站列表（分页排序）

接口地址：http://localhost:8080/uniapp/pile/queryStationInfos

请求类型：POST

入参

字段名 类型 是否必传 备注
stationLng String N 经度
stationLat String N 纬度
pageNum Number Y 页码
pageSize Number Y 每页数量
stationName String y 站点名称（搜索）

反参

字段名 类型 是否必传 备注
pageNum Number Y 页码
pageSize Number Y 每页数量
list Array Y 充电站列表
total Number Y 总数
pages Number Y 总页数

StationVO

字段名 类型 是否必传 备注
stationId String Y 站点id
stationName String Y 站点名称
stationAddress String Y 站点地址
stationImgList Array N 站点图片
distance String N 距离 单位千米
electricityPrice String Y 电费 每度单价
servicePrice String Y 服务费 每度单价
totalPrice String Y 总金额（电费+服务费）
fastTotal Number Y 快充枪口总数
fastFree Number Y 快充枪口空闲数
slowTotal Number Y 慢充枪口总数
slowFree Number Y 慢充枪口空闲数
stationLng String Y 经度
stationLat String Y 纬度

3001 查询充电桩详情

3002 查询充电桩枪口详情

接口地址：http://localhost:8080/uniapp/pile/selectConnectorListByParams

请求类型：POST

入参

字段名 类型 是否必传 备注
pageNum Number Y 页码
pageSize Number Y 每页数量
merchantId String N 运营商id ==接口暂未支持==
stationIdList Array N 站点id列表
pileIds Array N 充电桩id列表
connectorIdList Array N 枪口id列表
connectorCodeList Array N 枪口号列表

反参

字段名 类型 是否必传 备注
pageNum Number Y 页码
pageSize Number Y 每页数量
list Array Y 充电枪口对象
total Number Y 总数
pages Number Y 总页数

PileConnectorInfoVO

字段名 类型 是否必传 备注
connectorId String Y 充电枪口id
connectorCode String Y 枪口编号
connectorQrCodeUrl String Y 枪口二维码
status Number Y 状态 0：离网 (默认)；1：空闲；2：占用（未充电）；3：占用（充电中）；4：占用（预约锁定） ；255：故障
stationId String Y 站点id
merchantId String Y 运营商id
merchantName String Y 运营商名称
pileSn String Y 充电桩编号
type String Y 类型 1-直流接口 汽车桩+快充 2-交流接口 汽车桩+慢充 3-插座接口 电单车桩
instantPower BigDecimal Y 即时功率
electricity BigDecimal Y 电量
equipmentOrderNum String Y 设备订单号
platformOrderNum String Y 平台订单
chargingTime String Y 充电时长
voltage BigDecimal Y 电压
current BigDecimal Y 电流
gunLineTemperature String Y 枪线温度
userInfo String Y 用户信息
orderId String Y 订单id
carNo String Y 车牌号
soc String Y SOC
chargingAmount BigDecimal Y 充电金额
chargingDegree BigDecimal Y 充电度数
businessType y 经营类型（1-运营桩；2-个人桩）

示例：

#入参：
{
    "pageNum": 1,
    "pageSize":10,
    "connectorIdList":[1]
}

#反参：
{
    "resCode": "00100000",
    "msg": "操作成功",
    "obj": {
        "pageNum": 1,
        "pageSize": 10,
        "list": [
            {
                "connectorId": "1",
                "connectorCode": "8800000000000101",
                "connectorQrCodeUrl": "http://localhost/pileConnectorInfo&code=8800000000000101",
                "status": 0,
                "stationId": "2",
                "merchantId": "5",
                "merchantName": "举视(上海)新能源科技有限公司",
                "pileSn": "88000000000001",
                "type": "2",
                "instantPower": 0.00,
                "electricity": null,
                "equipmentOrderNum": null,
                "platformOrderNum": null,
                "chargingTime": null,
                "voltage": 0.0,
                "current": 0.0,
                "gunLineTemperature": "0",
                "userInfo": null,
                "orderId": null,
                "carNo": null,
                "chargingAmount": 0.00,
                "chargingDegree": 0.00,
                "soc": "0"
            }
        ],
        "total": 1,
        "pages": 1
    }
}

4001 启动充电

接口地址：http://localhost:8080/uniapp/order/generateOrder

请求方式：POST

入参

字段名 类型 是否必传 备注
pileSn String Y 桩编码
connectorCode String Y 枪口号
pileConnectorCode String Y 桩枪口编号（桩编码+枪口号）
memToken String Y 用户token（写在Header中）

备注：pileSn + connectorCode 或 pileConnectorCode 选其一，接口都支持

反参

字段名 类型 是否必传 备注
orderCode String Y 订单号

4002 结束充电

接口地址：http://localhost:8080/uniapp/order/settleOrder

请求方式：POST

入参

字段名 类型 是否必传 备注
orderCode String Y 订单号
pileSn String Y 桩编码
connectorCode String Y 枪口号
pileConnectorCode String Y 桩枪口编号（桩编码+枪口号）

反参

null，若成功，msg中会有“==操作成功==”提示

5001 查询订单列表

请求地址：http://localhost:8080/uniapp/order/getOrderList

请求方式：POST

入参

字段名 类型 是否必传 备注
memberId String Y 会员id
pageSize Number Y
pageNum Number Y
orderStatus String Y 订单状态 1-全部 2-未完成 3-已完成

反参

字段名 类型 是否必传 备注
orderCode String Y 订单号
pileSn String Y 桩编码
connectorCode String Y 枪口号
stationName String Y 站点名称
pileConnectorCode String Y 桩枪口编号（桩编码+枪口号）
chargingDegree BigDecimal Y 充电度数
orderAmount BigDecimal Y 订单金额
orderStatus String Y 订单状态(0-待支付；1-充电中；2-待结算；3-待补缴；4-异常；5-可疑；6-订单完成)
startTime String Y 订单开始时间
endTime String Y 订单结束时间
payAmount BigDecimal Y 用户支付金额
payStatus String Y 支付状态(0-待支付；1-支付完成)
reason String Y 订单异常原因

60001 查询余额明细

请求地址： http://localhost:8080/uniapp/member/getMemberBalanceChanges

请求方式：POST

入参

字段名 类型 是否必传 备注
memberToken String Y 会员令牌
type String Y 交易类型 1-进账；2-出账
pageSize
pageNum

反参

字段名 类型 是否必传 备注
memberId String Y 会员Id
principalBalance Number Y 当前账户本金余额
giftBalance Number Y 当前账户赠送余额
totalAccountAmount Number Y 账户总余额
type String Y 交易类型 1-进账；2-出账
subType String Y 子类型
amount String Y 出账/入账金额
transactionTime String Y 交易时间
category String Y 余额类型（1-本金，2-赠送）

7001 生成订单

请求地址：http://localhost:8080/uniapp/order/generateOrder

请求方式：POST

入参

字段名 类型 是否必传 备注
pileConnectorCode String Y 桩枪口编码
chargeAmount Number Y 充电金额

反参

字段名 类型 是否必传 备注
orderCode String Y 订单号

7002 支付订单

请求地址：http://localhost:8080/uniapp/pay/payOrder

请求方式：POST

入参

字段名 类型 是否必传 备注
orderCode String Y 订单号
payMode String Y 支付方式
payAmount String Y 支付金额

反参

null，提示”==操作成功==“

7003 订单停止充电

请求地址：http://localhost:8080/uniapp/order/stopCharging

请求方式：POST

入参

字段名 类型 是否必传 备注
orderCode String Y 订单号

反参

null，提示”==操作成功==“

首页大数据展示

8001 概况

请求地址：http://localhost:8080/index/getGeneralSituation

请求方式：POST

入参

字段名 类型 是否必传 备注
stationId String N 站点id

反参

字段名 类型 是否必传 备注
totalChargingDegree String Y 总充电电量
totalChargingAmount String Y 总充电费用
totalChargingQuantity String Y 总充电笔数
totalPileQuantity String Y 总设备数量
totalMemberAmount String Y 总客户余额

8002 订单

请求地址：http://localhost:8080/index/getOrderInfo

请求方式：POST

入参

字段名 类型 是否必传 备注
stationId String N 站点id

反参

字段名 类型 是否必传 备注
date String Y 日期
totalElectricity String Y 总用电量
totalOrderAmount String Y 总订单金额
totalSharpUsedElectricity String Y 尖时段总用电量
totalPeakUsedElectricity String Y 峰时段总用电量
totalFlatUsedElectricity String Y 平时段总用电量
totalValleyUsedElectricity String Y 谷时段总用电量

个人桩相关

9001 用户绑定个人桩

请求地址： http://localhost:8080/uniapp/personalPile/pileMemberBinding

请求方式： POST

入参

字段名 类型 是否必传 备注
pileSn String Y 桩编码
phoneNumber String Y 用户手机号码
verificationCode String Y 用户手机验证码

反参

9002 桩管理员下发给其他用户

请求地址：http://localhost:8080/uniapp/personalPile/adminIssuePile

请求方式： POST

入参

字段名 类型 是否必传 备注
PileSn String Y 桩编码
phoneNumber String Y 另一个用户的手机号码

9003 获取个人桩列表

请求地址： http://localhost:8080/uniapp/personalPile/getPersonalPileList

请求方式： GET

反参

List

字段名 类型 是否必传 备注
pileSn String Y 桩编码
connectorNum String Y 枪口数量==(2023.02.23新增)==
memberId String Y 会员id
type String Y 身份类型
modelName String Y 型号
ratedPower String Y 额定功率
ratedCurrent String Y 额定电流
ratedVoltage String Y 额定电压
speedType String Y 充电类型

9004 获取枪口实时数据

请求地址：http://localhost:8080/uniapp/personalPile/getConnectorRealTimeInfo

请求方式：POST

入参

字段名 类型 是否必传 备注
pileConnectorCode String Y 桩枪口号

反参

字段名 类型 是否必传 备注
instantCurrent Number Y 实时电流
instantVoltage Number Y 实时电压
instantPower Number Y 实时功率

9005 累积充电量数据

请求地址：http://localhost:8080/uniapp/personalPile/getAccumulativeInfo

请求方式：POST

入参

字段名 类型 是否必传 备注
pileConnectorCode String Y 桩枪口号
startTime String Y 开始日期
endTime String Y 结束日期

反参

字段名 类型 是否必传 备注
memberId String Y 会员id
startTime String Y 开始日期
endTime String Y 结束日期
sumChargingElectricity String Y 累计充电量
sumChargingTime String Y 累计充电时长

9006 充电记录

请求地址：http://localhost:8080/uniapp/personalPile/getChargingRecord

请求方式：POST

入参

字段名 类型 是否必传 备注
pileConnectorCode String Y 桩枪口号
pageNum Number Y 页码
pageSize Number Y 每页数量

反参

字段名 类型 是否必传 备注
startChargingTime String Y 启动时间
endChargingTime String Y 结束时间
chargingElectricity String Y 用电量
chargingTime String Y 充电时长
Reference in New Issue View Git Blame Copy Permalink