帮助中心 回调文档

新能源电池报告-回调文档

更多

加密规则:md5(time+appid+密钥)
#只有time appid参与加密,其它返回参数不参与,密钥与提交时的密钥是一致的

请求方式:POST

在接受到请求之后,请返回包函 success 的字段串,否则我们系统会在以下时间再次请求:5分钟,1小时,12小时

返回加密参数:

名称 类型 说明 示例
time Integer 时间戳 1603872381
appid Integer 提交数据时的appid,这里返回用于加密身份验证 1365
request_id String 请求唯一ID值 52a9dbe274a5c537bbf7a53e2d66c09f
request Array 提交上来的数据
sign String 签名
response Array 回调的数据

返回参数字段说明:

名称 类型 说明 示例
brand String 品牌名称 奇瑞
brand_id Integer 品牌id 75
brand_logo String 品牌logo
c_vin String 车辆VIN码,即汽车车架号;一般在发动机、前档玻璃左下角会显示 LSVAL41Z882104202
display_mileage Integer 表显⾏驶⾥程 51500
id Integer 唯一id 775
key String 字段
list Array 列表数据 [{"tab":"静态数据","title":"⻋辆电池静态数据","sub_list":[{"key":"电池⼚商","value":"芜湖奇达动⼒电池系统有限公司","text":"","text_color":0},{"key":"标称电池容量","value":"204 A.h","text":"","text_color":0},{"key":"标称续航⾥程","value":"510 km","text":"","text_color":0},{"key":"系统标称能量","value":"70.10 kWh","text":"","text_color":0},{"key":"电池类型","value":"三元材料电池","text":"","text_color":0}]},{"tab":"电池健康","title":"动⼒电池评估数据","sub_list":[{"key":"当前参考续航","value":"381 km","text":"↓25.3%","text_color":2},{"key":"电池健康度","value":81.49,"text":"较差","text_color":1},{"key":"电池衰退速率","value":1,"text":"","text_color":0},{"key":"安全风险水平等级","value":"较低","text":"","text_color":0},{"key":"安全风险水平解析","value":"本⻋动⼒电池SOH(电池健康度)为81.49<\/strong>%,⻋辆电池衰退速率超过同类⻋型平均的1.0<\/strong>倍,动⼒系统发⽣严重故障的概率较低。","text":"","text_color":0}]},{"tab":"充电数据","title":"⻋辆充放电数据","sub_list":[{"key":"总充电次数","value":1590,"text":"","text_color":0},{"key":"循环次数","value":690.06,"text":"","text_color":0},{"key":"快充占⽐","value":"72%","text":"偏⾼","text_color":4},{"key":"电池使⽤习惯评估","value":"良好","text":"","text_color":0},{"key":"⻋辆充放电模块-注意","value":"快充占⽐偏⾼,电池容易衰退。","text":"","text_color":0},{"key":"⻋辆充放电模块-建议","value":"减少快充⽐例。","text":"","text_color":0}]},{"tab":"⾏驶数据","title":"⻋辆⾏驶数据","sub_list":[{"key":"表显⾏驶⾥程","value":"51500 km","text":"","text_color":0},{"key":"表显⾏驶⾥程更新时间","value":"2024-08-05","text":"","text_color":0},{"key":"⻋辆⽣产年份","value":"2020","text":"","text_color":0},{"key":"是否疑似调表","value":"否","text":"","text_color":0}]}]
manufacturer_date String ⻋辆⽣产⽇期 2020
market_name String 车型名称 比亚迪 秦新能源
market_price String 市场价
order_id
query_time String 查询时间 2025-01-04
rate_mileage Integer 标称续航⾥程 510
refer_rate_mileage Integer 当前参考续航 381
refer_rate_mileage_assess String 当前参考续航对比 ↓25.3%
refer_rate_mileage_text_color Integer 标称续航⾥程颜色 2
result Array 查询结果列表 [{"dangerSingleType":"2","dangerSingleName":"\u524d\u4fdd\u9669\u6760(\u5168\u55b7)","dangerSingleMoney":"70000"}]
result_status String 查询状态(1成功, 2查询中, 3失败) 1
sub_list Array 子列表 [{"key":"表显⾏驶⾥程","value":"51500 km","text":"","text_color":0},{"key":"表显⾏驶⾥程更新时间","value":"2024-08-05","text":"","text_color":0},{"key":"⻋辆⽣产年份","value":"2020","text":"","text_color":0},{"key":"是否疑似调表","value":"否","text":"","text_color":0}]
tab String 标签 ⾏驶数据
text String 描述
text_color Integer 描述颜色 0
title String 标签名字 ⻋辆⾏驶数据
usage_date Integer 已使⽤日期 0
value String 字段值

JSON回调示例:

PHP代码回调示例:

$secret = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'; //提交查询是的appid 对应的密钥。
$sign = $_POST['sign'];
$md5sign = md5($_POST['time'].$_POST['appid'].$secret);
if($md5sign==$sign){
    //通过验证,在条件内完成其它逻辑操作
    //下面是回调的数据。也就是查询结果
    $response = json_decode($_POST['response'],true);
    //下面是您提交查询时请求的数据;如果有提交自定义参数,在这里面可以找到
    $request = json_decode($_POST['request'],true);
    //下面的逻辑代码请自行编写

    echo 'success'; //不要删除,用于通知服务器接收到回调信息
}else{

    echo 'fail';
    /**
     * 返回失败后服务器会继续回调,分别在以下时间内回次回调
     * 10分钟
     * 1小时
     * 12小时
     * 总共尝试回调4次,4次之后不再回调
    */
}

                    

查看接口详情