Files
jsowell-charger-web/doc/接口文档.md
2023-03-04 16:29:55 +08:00

135 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 根据充电桩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 | | 车牌号 |