docs: 轮询配置接口文档与实际行为对齐
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m57s

- 匹配预览 GET 只收 query iccid,POST 只收请求体,去掉 POST 文档中多余的 query 参数
- 预览草稿 overrides 改为独立结构,字段全部可选,最多 20 条
- clear_fields 用具名类型生成数组元素枚举;ordered_ids 说明须为正整数且不重复
This commit is contained in:
邹进
2026-10-24 17:41:52 +09:00
parent 8fc3485061
commit 2ddaffe373
5 changed files with 67 additions and 31 deletions

View File

@@ -3,6 +3,7 @@ package polling
import (
"context"
"fmt"
"github.com/break/junhong_cmp_fiber/internal/model/dto"
"github.com/break/junhong_cmp_fiber/internal/model"
"github.com/break/junhong_cmp_fiber/pkg/constants"
@@ -74,9 +75,9 @@ func validPackageState(state string) bool {
}
// applyPollingConfigClearFields 把指定字段清空为 NULL:间隔清空即改为继承,匹配条件清空即不限。
func applyPollingConfigClearFields(cfg *model.PollingConfig, fields []string) error {
func applyPollingConfigClearFields(cfg *model.PollingConfig, fields []dto.PollingConfigClearField) error {
for _, field := range fields {
switch field {
switch string(field) {
case "realname_check_interval":
cfg.RealnameCheckInterval = nil
case "carddata_check_interval":
@@ -96,7 +97,7 @@ func applyPollingConfigClearFields(cfg *model.PollingConfig, fields []string) er
case "pre_reset_carddata_interval":
cfg.PreResetCarddataInterval = nil
default:
return errors.New(errors.CodeInvalidParam, "轮询配置参数不合法:不支持清空字段 "+field)
return errors.New(errors.CodeInvalidParam, "轮询配置参数不合法:不支持清空字段 "+string(field))
}
}
return nil