ChargingStationHTTPAPI
  1. 充电设施管理
ChargingStationHTTPAPI
  • 桩企接入流程请先读我
  • 站点数据管理
    • 充电站管理
      • 提交一个充电站信息
      • 删除一个充电站信息
      • 修改一个充电站信息
      • 分页查询多个充电站信息列表
    • 充电设施管理
      • 提交一个充电设施信息
        POST
      • 删除一个充电设施信息
        DELETE
      • 修改一个充电设施信息
        PUT
      • 分页查询多个充电设施信息列表
        GET
    • 充电口管理
      • 提交一个充电口信息
      • 删除一个充电口信息
      • 修改一个充电口信息
      • 分页查询多个充电口信息列表
  • 实时数据上报
    • 上报回调地址管理
      • 修改上报失败回调地址
      • 删除上报失败回调地址
      • (运营商实现该接口)处理上报失败
      • 修改查询充电口实时数据回调地址
      • 修改请求上报充电过程数据地址
      • (运营商实现该接口)处理请求上报充电过程数据
    • 上报充电口实时信息
      POST
    • 重新上报充电口实时信息
      POST
    • 上报充电口实时信息列表
      POST
  • 运营数据管理
    • 充电记录管理
      • 提交一个充电记录信息
      • 分页查询多个充电记录信息列表
      • 提交充电记录信息列表
  • 安全预警管理
    • 安全预警请先读我
    • 修改安全预警回调地址
      PUT
    • (桩企实现)安全预警接口举例
      POST
  • 获取运营商operator token
    GET
  1. 充电设施管理

提交一个充电设施信息

开发中
POST
/platform/management/equipment

请求参数

Header 参数
Datetime
string 
必需
调用接口的时间 yyyy-MM-dd HH:mm:ss
示例值:
2022-02-28 13:45:04
OperatorId
string 
运营商 id
必需
示例值:
运营商 id
Token
string 
必需
调用 /platform/management/operatorAPIToken 的返回结果
示例值:
平台分发的 token
Signature
string 
必需
详见 /platform/management/operatorAPIToken,用户身份签名,对字符串"datetime: yyyy-MM-dd HH:mm:ss\noperatorid: thisisanoperatorid\ntoken: thisisantoken" 的 HMAC 散列的 base64 编码
示例值:
用户身份签名
Body 参数application/json
equipmentId
string 
设备编码
必需
设备唯一编码,对同一运营商,保证唯一
stationId
string 
所属站点ID
必需
所属站点ID
operatorId
string 
运营商ID
必需
运营商ID
equipmentName
string 
设备名称
必需
设备名称, 几号桩或者没有用设备编码代替
manufacturerBrand
string 
设备品牌
必需
没有品牌填写运营商名称
equipmentModel
string 
设备型号
必需
由设备生厂商定义的
manufacturerId
string 
生产商ID
必需
组织机构代码
productionDate
string 
设备生产日期
必需
yyyy-MM-dd
equipmentType
integer 
设备类别
必需
1 :交流 2:直流设备 3:交直流一体设备
equipmentCategory
integer 
设备类型
必需
1:充电桩、2:充电柜、3:换电柜
validateConnectorCount
integer 
有效的充电接口数量
必需
有效的充电接口数量
ratedVoltage
number 
整机额定电压
必需
保留小数点后一位
ratedCurrent
number 
整机额定电流
必需
保留小数点后一位
ratedPower
number 
整机额定功率
必需
保留小数点后一位
equipmentLng
number 
充电设备经度
必需
GCJ-02坐标系保留小数点后6位
equipmentLat
number 
充电设备纬度
必需
GCJ-02坐标系保留小数点后6位
operationDate
string 
投运日期
必需
yyyy-MM-dd
camera
integer 
是否有摄像头
必需
1:是
2:否
3:未知
示例
{
    "equipmentId": "84",
    "equipmentName": "标至律作",
    "manufacturerBrand": "et",
    "manufacturerId": "93",
    "equipmentType": 84,
    "equipmentCategory": 32,
    "validateConnectorCount": 83,
    "ratedVoltage": 96,
    "ratedCurrent": 92,
    "ratedPower": 41,
    "equipmentLng": 92,
    "equipmentLat": 89,
    "stationId": "51",
    "operatorId": "31",
    "equipmentModel": "nostrud laborum voluptate sit",
    "productionDate": "2013-12-08",
    "operationDate": "1982-03-26",
    "camera": 26
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/platform/management/equipment' \
--header 'Datetime: 2022-02-28 13:45:04' \
--header 'OperatorId: 运营商 id' \
--header 'Token: 平台分发的 token' \
--header 'Signature: 用户身份签名' \
--header 'Content-Type: application/json' \
--data-raw '{
    "equipmentId": "84",
    "equipmentName": "标至律作",
    "manufacturerBrand": "et",
    "manufacturerId": "93",
    "equipmentType": 84,
    "equipmentCategory": 32,
    "validateConnectorCount": 83,
    "ratedVoltage": 96,
    "ratedCurrent": 92,
    "ratedPower": 41,
    "equipmentLng": 92,
    "equipmentLat": 89,
    "stationId": "51",
    "operatorId": "31",
    "equipmentModel": "nostrud laborum voluptate sit",
    "productionDate": "2013-12-08",
    "operationDate": "1982-03-26",
    "camera": 26
}'

返回响应

🟢200成功
application/json
Body
status
integer 
必需
message
string 
必需
data
string 
必需
示例
{
    "status": 200,
    "message": "请求成功!",
    "data": "提交成功!"
}
修改于 2022-03-30 12:53:14
上一页
分页查询多个充电站信息列表
下一页
删除一个充电设施信息
Built with