AGV系统API调用示例项目

项目介绍

这是一个基于Java的AGV系统API调用示例项目，根据接口文档实现了HTTP请求功能，包括签名和非签名请求的处理。

项目结构

├── src/main/java/com/agv/api/
│   ├── HttpRequestUtil.java  # HTTP请求工具类
│   ├── SignUtil.java         # 签名工具类
│   └── AgvApiDemo.java       # 主类，包含API调用示例
├── pom.xml                   # Maven项目配置文件
└── 接口文档.md               # AGV系统接口文档

功能说明

1. HTTP请求工具类 (HttpRequestUtil)

• 支持发送GET和POST请求
• 自动生成接口文档要求的请求头信息
• 支持签名和非签名请求模式
• 提供请求和响应处理功能

2. 签名工具类 (SignUtil)

• 根据接口文档1.3章节实现了加密签名功能
• 支持HMAC-SHA256和HMAC-SHA512算法
• 按照接口要求提取参与签名的首部字段
• 生成符合规范的签名

3. API调用示例 (AgvApiDemo)

• 任务下发接口调用示例
• 任务取消接口调用示例
• 任务执行过程回馈接口调用示例
• 交管区域申请和释放接口调用示例
• 请求资源接口调用示例
• 演示签名和非签名请求的使用方法

环境要求

• JDK 1.8或更高版本
• Maven 3.0或更高版本

使用方法

1. 克隆或下载项目到本地

2. 修改配置参数

• 在AgvApiDemo.java文件中修改BASE_URL、APP_KEY和APP_SECRET参数
• 根据实际环境配置目标AGV系统的地址和认证信息

1. 构建项目

mvn clean package

1. 运行项目 或者直接在IDE中余小宁AgvApiDemo中的main方法

java -jar target/java-api-demo-1.0-SNAPSHOT.jar

注意事项

1. 本示例中的请求数据为模拟数据，实际使用时需要根据业务需求修改

2. 签名计算需要正确的appSecret，请确保配置正确

3. 接口调用超时时间设置：连接超时30秒，数据返回超时60秒

4. 如遇到问题，请参考接口文档中的错误代码说明进行排查

接口文档说明

项目包含了完整的AGV系统接口文档，详细说明了各种接口的请求参数、响应参数、错误代码等信息。请参考接口文档.md文件了解更多详情。

常见问题

1. 签名验证失败：请检查appSecret是否正确，以及参与签名的首部字段是否完整

2. 连接超时：请检查目标AGV系统的网络连接是否正常

3. 参数验证失败：请检查请求参数是否符合接口文档的要求

4. 权限不足：请确认当前应用是否有足够的权限调用目标接口