同步充电记录

接口描述

1. 充电过程中定时上报充电进度；
2. 充电完成上报充电账单；
3. 充电启动失败上传记录；
4. 也可用于充电减免停车费场景。充电完成上传充电记录（车牌必须），平台会匹配充电站对应停车场的优惠规则进行下发。

接口地址

• 测试环境：https://dev-api.4pyun.com/gate/1.0/energy/internal/replenish/sync
• 生产环境：https://api.4pyun.com/gate/1.0/energy/internal/replenish/sync

请求方式：POST

数据类型：application/json; charset=utf-8

请求头

请求参数

响应参数

响应码

示例代码

SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
format.setTimeZone(TimeZone.getTimeZone("UTC"));

// 请求参数
TreeMap<String, Object> args = new TreeMap<String, Object>() {{
    put("app_id", APP_ID);
    put("station_uuid", "8f5fdb60-9374-4c11-bdc2-a32d8369258c");
    put("order", "202404111434431656839748");
    put("start_time", format.format(DateTime.now().minusHours(1).toDate()));
    put("end_time", format.format(new Date()));
    put("vin", "");
    put("plate", "川A660PP1");
    put("quantity", 1000);
    put("energy_value", 1);
    put("fee_value", 1);
    put("state", 3);
    put("state_desc", "充电完成");
    put("device_no", "D012026");
    put("device_tyoe", 0);
    put("port_no", "D01202601");
    put("energy_code", "CN_AC");
    put("soc", 100);
    put("mobile", "13800138000");
}};

// 计算签名
String content = JSON.toJSONString(args);
String plain = content + "&app_secret=" + APP_SECRET;
String sign = MD5.encryptHEX(plain);

// 请求接口
HttpResponse response = Request.Post("https://api.4pyun.com/gate/1.0/energy/internal/replenish/sync")
        .addHeader("Authorization", sign)
        .addHeader("Content-Type", "application/json; charset=utf-8")
        .bodyString(content, ContentType.APPLICATION_JSON)
        .execute()
        .returnResponse();
// 注意：非200也会返回响应体
System.out.println(response.getStatusLine());
System.out.println(EntityUtils.toString(response.getEntity()));

签名规则

1. 将密钥以 & 为分隔符添加到请求体中JSON字符串后面，生成待签名字符串；
2. 使用标准MD5算法对待签名字符串进行签名；
3. 将签名值写入请求头的 Authorization 字段。

例如：
待签名字符串：{"a":"string","b":0,"c":1900000109}&app_secret=您的密钥
正确签名：d7f3eca20c666483b2f4963d35a3f547