ESP32-EVSE项目WebAPI使用指南

ESP32-EVSE项目WebAPI使用指南

项目背景

ESP32-EVSE是一个基于ESP32微控制器的电动汽车充电站(EVSE)开源项目。该项目提供了完整的硬件和软件解决方案，包括一个功能丰富的Web界面和REST API接口，用于远程监控和控制充电过程。

WebAPI使用要点

基础路径变更

最新版本的ESP32-EVSE项目已将REST API的基础路径从原来的根目录变更为/api/v1。这一变更使得API接口更加规范，同时也避免了与Web界面的路由冲突。

常见API端点

1. 获取EVSE配置信息

   GET /api/v1/config/evse
   

2. 修改充电电流设置

   POST /api/v1/config/evse
   Body: { "chargingCurrent": 11 }
   

请求格式要求

所有API请求必须包含正确的Content-Type头部：

Content-Type: application/json

常见错误处理

1. 404错误：通常是由于使用了错误的基础路径
2. 405方法不支持：检查请求方法是否正确(POST/GET)
3. 400错误：请求体格式不正确

调试建议

1. 使用浏览器开发者工具观察Web界面发出的API请求
2. 对于PowerShell用户，可以使用Invoke-WebRequest或Invoke-RestMethod命令
3. 确保请求体是有效的JSON格式（注意使用双引号而非单引号）

项目文档现状

需要注意的是，目前项目的Wiki文档可能未完全同步最新代码变更。建议开发者通过以下方式获取最新API信息：

1. 直接查看项目源代码中的路由定义
2. 使用浏览器开发者工具分析Web界面发出的请求
3. 参考项目issue区的最新讨论

总结

ESP32-EVSE项目提供了完善的API接口用于远程控制充电站。开发者在使用时需要注意基础路径的变更，并确保请求格式正确。随着项目的持续发展，建议保持对代码变更的关注，以获得最佳开发体验。