FtpTool/testapi.txt
dark c1ced1b7b6 feat: 对齐生产真实接口协议并补充ACK回传与最小增量同步
- 按 testapi.txt 的正式协议重写生产接口适配
- 将 pushConfig 调整为 POST + JSON 数组方式推送配置
- 将 pullConfig 调整为 GET + JSON 列表方式拉取配置
- 新增 login 接口适配,支持 token 获取与本地缓存
- 新增 prod_pull_ack 表、实体、仓储与服务,支持 ackSuc/ackFail 回传
- 在 ProdSyncCoordinator 中串联 pullConfig 成功/失败回执记录逻辑
- 为 Git -> PROD 链路增加最小增量推送能力,删除文件场景自动回退全量
- 扩展 WorkDirectoryService 与 FileTreeUtils,支持增量基线目录和选择性文件复制
- 更新 application.properties 与 application-prod-agent.properties 的生产接口配置项
- 重写 prod-api-v1.md,使接口文档与真实生产协议一致
- 补充 HTTP 层与主链路测试,覆盖 ack 参数回传和最小增量同步
- 保留 configContent 加解密逻辑为 TODO
2026-04-28 10:33:49 +08:00

126 lines
2.1 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

1git中转服务推送GIT配置到生产的接口
接口地址:http://ip:port/pic_bus_manage_monitor/configSync/pushConfig
请求方式:post
内容格式:json
编码:UTF-8
HEADER里带token用于鉴权
请求参数:无
请求体:[{
"airportId":"test",
"appName":"XXX",
"configVersion":"R_XXX_V3.0.3_XXX"
"configContent":"配置内容",
"fileName":"配置文件名"
}]
响应:{
"code":"0",
"data":{"ackFail":[{
"airportId":"test",
"appName":"XXXx",
"configVersion":"R_XXX_V3.0.35.6.1_XXX"
"fileName":"配置文件名"
}]},
"msg":"ok"
}
备注:配置推送第一次全量,之后增量,全量配置较大,需视情况分多次推送。配置需加密,加密方式留成TODO。
2git中转服务从生产拉取配置到GIT的接口
接口地址:http://ip:port/pic_bus_manage_monitor/configSync/pullConfig
请求方式:get
内容格式:json
编码:UTF-8
HEADER里带token用于鉴权
请求参数:{
"airportId":"test",
"appName":"XXXx",
"configVersion":"R_XXX_V3.0.35.6.1_XXX",
"fileName":"配置文件名",
"ackSuc":"id,id"
"ackFail":"id,id"
}
响应:
{
"code":"0",
"data":[{
"id":"1",
"airportId":"test",
"appName":"XXXx",
"configVersion":"R_XXX_V3.0.35.6.1_XXX"
"configContent":"配置内容(加密)",
"fileName":"配置文件名"
}],
"msg":"ok"
}
备注不带参数则返回未同步到git的所有已审核通过的配置。配置需加密,加密方式留成TODO。
3git中转服务获取token的接口(已有接口)
接口地址:http://ip:port/pic_bus_manage_monitor/pam-monitor/login
请求方式:post
内容格式:json
编码:UTF-8
请求参数:{
"name":"XXXxx",
"password":""
}
响应:
{
"code":"0",
"data":{"token""tetttwe","expireTime":"2026-07-11 11:11:11"},
"msg":"ok"
}
备注:若token过期重新调用登录接口获取token
所有接口失败时的响应格式:
{
"code": "XXX-00-00-XXX",
"data": null,
"msg": "errmsg",
"timestamp": "1776735560594"
}