Files
jsowell-charger-web/doc/接口文档.md

135 lines
7.5 KiB
Markdown
Raw Normal View History

2023-03-04 16:29:55 +08:00
# 根据充电桩id查询详情接口
>根据充电桩id查询相关信息包括运营商信息、充电站信息、充电枪信息、协议信息、sim卡信息等。
入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ------ | ------ | -------- | -------- |
| pileId | String | Y | 充电桩id |
反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | ---------------------------- |
| sn | String | Y | sn号 |
| stationName | String | Y | 站点名称 station |
| merchantName | String | Y | 运营商名称 merchant |
| pileType | String | Y | 设备类型(1-汽车桩2-电单车) model |
| gunNum | int | Y | 枪数量 model |
| interfaceStandard | String | Y | 接口标准 model |
| ratedPower | int | Y | 额定功率(单位W) model |
| outputCurrent | int | Y | 输出电流(单位A) model |
| ICCID | String | Y | sim卡信息 |
| registrationTime | String | Y | 注册时间 licence |
| expireTime | String | Y | 到期时间 licence |
![image-20220924155754954](C:\Users\李苗苗\AppData\Roaming\Typora\typora-user-images\image-20220924155754954.png)
## 站点管理列表
#### 反参
PileStationVO
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------- | -------- | :----------: |
| id | String | | 站点id |
| stationName | string | | 站点名称 |
| areaCode | S | | 省市辖区编码 |
| area | S | | 地区 |
| address | S | | 地址 |
| PileNum | Integer | | 充电设备数量 |
| merchantId | S | | 运营商ID |
| merchantName | S | | 运营商名称 |
| merchantAdminName | S | | 运营商管理员 |
| stationStatus | Integer | | 站点状态 |
| stationType | s | | 站点类型 |
| createTime | s | | 创建时间 |
| stationTel | s | | 站点电话 |
| matchCars | s | | 适用车型描述 |
| stationLng | s | | 经度 |
| stationLat | s | | 纬度 |
| construction | s | | 建设场所 |
| businessHours | s | | 营业时间描述 |
| organizationCode | s | | 组织结构代码 |
| publicFlag | s | | 是否对外开放 |
| openFlag | s | | 是否营业中 |
## BatchCreatePileDTO
| 字段名 | 类型 | | 备注 |
| ---------------- | ---- | ---- | ---------------------------- |
| merchantId | s | | 运营商id |
| stationId | s | | 充电站id |
| modelId | s | | 型号id |
| softwareProtocol | s | | 软件协议1-云快充2-永联) |
| productionDate | Date | | 生成日期 |
| connectorNum | int | | 接口数量 |
| num | int | | 生成台数 |
| remark | s | | 备注 |
### 计费模板时段详情
```
CreateBillingTemplateDTO
```
| 字段名 | 类型 | | 备注 |
| ----------------- | -------------------------------------- | ---- | ---------------------------------------- |
| name | s | | 模板名称 |
| type | s | | 时段类型 |
| electricityPriceA | BigDecimal | | 尖时段电费 |
| servicePriceA | BigDecimal | | 尖时段服务费 |
| electricityPriceB | BigDecimal | | 峰时段电费 |
| servicePriceB | | | 峰时段服务费 |
| electricityPriceC | | | 平时段电费 |
| servicePriceC | | | 平时段服务费 |
| electricityPriceD | | | 谷时段电费 |
| servicePriceD | | | 谷时段服务费 |
| remark | s | | 备注 |
| 时段清单 | private List<BillingTimeDTO> timeList; | | |
| type | String | | 时段类型1-尖时2-峰时3-平时4-谷时 |
| timeDesc | s | | 时段 例如0000-0500 |
### 快速建站DTO FastCreateStationDTO
| 字段名 | | | 备注 |
| ----------- | ---- | ---- | ------------ |
| merchantId | S | | 所属运营商id |
| stationName | S | | 名称 |
| address | S | | 地址 |
| areaCode | S | | 区域 |
### 站点导入计费模板dto ImportBillingTemplateDTO
| 字段名 | 类型 | | 备注 |
| ----------------- | ---- | ---- | ---------- |
| stationId | | | 站点id |
| billingTemplateId | | | 计费模板id |
### 查询充电枪返回前台参数
PileConnectorInfoVO
| 字段名 | 类型 | | 备注 |
| ------------------ | ---- | ---- | --------------------------- |
| connectorId | S | | 充电枪口id |
| connectorCode | S | | 枪口编号由充电桩SN+01生成 |
| connectorQrCodeUrl | S | | 充电二维码 |
| status | int | | 状态 |
| type | S | | 类型 |
| instantPower | B | | 即时功率 |
| electricity | big | | 电量 |
| SOC | S | | SOC |
| plantformOrderNum | S | | 平台订单 |
| equipmentOrderNum | S | | 设备订单号 |
| chargingTime | S | | 充电时长 |
| voltage | B | | 电压 |
| current | B | | 电流 |
| temperature | B | | 温度 |
| userInfo | S | | 用户信息 |
| orderId | S | | 订单id |
| carNo | S | | 车牌号 |