全国400服务热线
400-995-9993
接口简介：新能源车辆云检测，包括：电池续航、电池健康度、电池衰退水平值、总充电次数、循环次数 等数据。
- Api文档
- 状态码说明
- Demo示例
子接口：
接口地址： https://登录后显示/pyi/262/466(支持:http/https)
返回格式：json,xml,jsonp调用
请求方式：GET,POST
POST 请求需要设置Header头：Content-Type: application/x-www-form-urlencoded;charset=utf-8
Api测试工具请求说明：
| 名称 | 必填 | 类型 | 说明 | 示例 参数另存 |
|---|---|---|---|---|
| appid | 是 | String | 应用ID，在后台我的应用查看或者添加 | |
| c_vin | 是 | String | 车架号(VIN)，字母大写；与行驶证图二选一，vin优先 | |
| debug | 否 | String | 调试参数，当此值为1时，返回的为虚拟调试数据。使用接口对接完成之后请去掉些参数即可 | |
| format | 否 | String | 返回数据格式类型，每个接口已经说明支持返回格式:json,xml, jsonp调用方法说明 | |
| new_energy_image | 否 | File | 行驶证图片URL，图片不大于10MB；与c_vin二选一 | |
| sign | 是 | String | 1.使用Md5方式验证，参数按一定规则md5后返回的字符串，详情点击这里阅读 2.使用Hash验证方式，直接跟上密钥即可。如何设置hash验证 通过我的应用里面修改验证方式 |
Md5验证方式-加密顺序
sign = MD5(
appid1c_vinLSVAL41Z882104202debug1formatjsonnew_energy_imagehttps://weicha.xmwama.cn/images/weicha/example.png密钥) 查看加密规则说明 密钥不需要键名，请直接跟上32位的密钥
返回参数说明：
| 名称 | 必填 | 类型 | 说明 | 示例 参数另存 |
|---|---|---|---|---|
| c_battery_habit_assess | 否 | String | 电池使用习惯评估：优秀/良好/中等/较差 | 优秀 |
| c_battery_manufacturer | 否 | String | 电池厂商 | 宁德时代 |
| c_battery_soh | 否 | Double | 电池健康度(SOH) | 96.37 |
| c_battery_soh_lv | 否 | String | 电池健康度(SOH)-解析：优秀/良好/中等/较差/差 | 优秀 |
| c_battery_type | 否 | String | 电池类型 | 三元材料电池 |
| c_brand | 否 | String | 车型品牌 | AITO问界 |
| c_fast_ratio | 否 | Double | 快充占比(%) | 0 |
| c_fast_ratio_assess | 否 | String | 快充占比-解析：正常/偏高 | 正常 |
| c_manufacturer_date | 否 | String | 车辆生产年份 | 2024 |
| c_nominal_energy | 否 | Double | 标称能量(kWh) | 40.06 |
| c_rate_capacity | 否 | Double | 标称容量(Ah) | 114 |
| c_rate_mileage | 否 | Integer | 标称续航(km) | 240 |
| c_refer_rate_mileage | 否 | Integer | 当前参考续航(km) | 211 |
| c_refer_rate_mileage_assess | 否 | String | 当前参考续航-解析 | ↓12.1% |
| c_total_charge_count | 否 | Integer | 总充电次数 | 30 |
| c_total_charge_soc | 否 | Double | 循环次数 | 281.89 |
| c_volume_score_recession | 否 | Double | 电池衰退水平值 | 0 |
| c_volume_score_recession_lv | 否 | String | 安全风险水平-等级：低/较低/较高/高 | 低 |
| c_volume_score_recession_narrate | 否 | Array | 安全风险水平-解析(数组，可能含html标签) | |
| codeid | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 |
| message | 否 | String | 请求状态说明 | 查询成功 |
| retdata | 否 | Array | 回数据集合,可能是数据、对象或者字符串 | |
| time | 否 | String | 请求时传递的当前服务器时间戳 | 1784603157 |
JSON返回示例：
服务器状态码：
| 状态码 | 说明 |
|---|---|
| 10000 | 返回成功 |
| 10001 | appid必须指定，可以我的应用里面查看 |
| 10002 | sign值必须指定，加密规则请前往帮助中心查看 |
| 10003 | sign值验证不通过，加密规则请前往帮助中心查看 |
| 10004 | 时差不能超过10分钟，可以不传递这个参数，注意时间戳单位是秒 |
| 10005 | appid错误，请检查appid值,前往会员中心->我的应用查看或添加 |
| 10006 | 当前IP地址未授权，请前往用户中心->我的应用添加ip{@info} |
| 10007 | 应用被禁用，请联系客服处理 |
| 10008 | 应用内没有该接口，请到我的应用里面添加这个接口 |
| 10009 | api接口不存在 |
| 10010 | 您没有添加该api接口 |
| 10011 | api已经到期 |
| 10012 | 没有订购任何api,请前往购买后再操作 |
| 10013 | 该接口已经暂停使用 |
| 10014 | 未知的错误，可以联系客服处理 |
| 10015 | 参数个数错误 |
| 10019 | {@info} |
| 10017 | time必须是整型 |
| 10018 | 次数不足 |
| 10020 | 子接口不存在,可能已经被关闭 |
| 10021 | 服务器发生错误 |
| 10022 | 帐户余额不足，请充值！ |
| 10023 | 订单提交成功，等待回调结果 |
| 10024 | 调试模式数据 |
| 10025 | 查无数据 |
请选择下载文件开发语言：(部分文件格式浏览器可能提示风险或者屏蔽)
