# syncOpenAPI

**Repository Path**: TaoLJA/sync-open-api

## Basic Information

- **Project Name**: syncOpenAPI
- **Description**: 定时调用vivo openAPI
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-30
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sync Open API 项目说明

这是一个基于Spring Boot的后端服务项目，主要用于处理与Vivo开放平台相关的API交互，并通过定时任务执行数据同步操作。

## 主要功能

- Excel文件读取与处理
- JSON文件读取
- 与Vivo开放平台API进行交互（POST/GET请求、视频上传、DMP标签文件上传）
- 定时任务调度以实现数据同步

## 技术栈

- Java 8+
- Spring Boot
- OkHttpClient
- Scheduled Tasks
- Maven (通过pom.xml管理依赖)

## 目录结构

```
src/
├── main/
│   ├── java/
│   │   └── com/
│   │       └── zw/
│   │           └── syncopenapi/
│   │               ├── SyncOpenApiApplication.java       // 应用启动类
│   │               └── common/
│   │                   ├── ExcelFileUtils.java           // Excel文件处理工具类
│   │                   ├── InventoryScheduler.java       // 定时任务调度类
│   │                   ├── JsonFileReader.java           // JSON文件读取类
│   │                   └── VivoApiUtil.java              // Vivo开放平台API交互类
│   │
│   └── resources/
│       ├── application.yml                               // 配置文件
│       └── static/
│           └── index.html                                // 静态页面（暂未详细实现）
│
├── pom.xml                                                 // Maven项目配置文件
└── .gitignore                                              // Git忽略文件配置
```

## 配置说明

在`application.yml`中需要配置以下参数：

- `tempFilePath`: 临时文件存储路径
- `jsonFilePath`: JSON文件存储路径
- `oaidFilePath`: OAID文件存储路径

## 使用方法

1. **启动应用**

   运行`SyncOpenApiApplication`类中的`main`方法启动Spring Boot应用。

2. **定时任务**

   每天晚上10点自动执行数据同步任务，具体逻辑在`InventoryScheduler`类的`resetModify`方法中定义。

3. **Excel文件处理**

   - 获取指定目录下的所有Excel文件
   - 获取最新修改的Excel文件
   - 计算文件的MD5值
   - 读取Excel文件中的某一列数据并转换为字符串列表
   - 将字符串列表转换为文本文件

4. **JSON文件处理**

   - 从指定路径读取JSON文件内容并解析为`JSONArray`

5. **Vivo API交互**

   - 发送POST/GET请求到Vivo开放平台
   - 上传视频文件
   - 上传DMP标签文件

## 注意事项

- 确保服务器上存在配置文件中指定的文件路径。
- 需要网络访问权限以连接Vivo开放平台API。
- 定时任务的时间间隔可以通过修改`@Scheduled`注解中的cron表达式来调整。

## 许可证

本项目遵循MIT许可证，请参阅[MIT License](https://opensource.org/licenses/MIT)以获取更多信息。