break
c64f3d8b80
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m31s
181 lines
18 KiB
Go
181 lines
18 KiB
Go
package dto
|
||
|
||
// AuditEventListRequest 是平台审计事件列表的组合筛选参数。
|
||
type AuditEventListRequest struct {
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间，RFC3339且含时区" example:"2026-08-01T00:00:00+08:00"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间，RFC3339且含时区，不包含该时刻" example:"2026-08-08T00:00:00+08:00"`
|
||
Action string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code，不按中文名称猜测"`
|
||
Category string `json:"category" query:"category" enum:"configuration,reliability,asset,security,identity,business" description:"动作类别 (configuration:配置, reliability:可靠性, asset:资产, security:安全, identity:身份, business:业务)"`
|
||
ActorKind string `json:"actor_kind" query:"actor_kind" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
|
||
ActorID string `json:"actor_id" query:"actor_id" description:"操作者稳定ID"`
|
||
Source string `json:"source" query:"source" enum:"admin_api,personal_api,openapi,worker,scheduler,callback" description:"操作入口来源 (admin_api:后台管理API, personal_api:个人客户API, openapi:代理OpenAPI, worker:异步Worker, scheduler:计划任务, callback:外部系统回调)"`
|
||
Result string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
|
||
Risk string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
|
||
ScopeType string `json:"scope_type" query:"scope_type" enum:"platform,shop,personal_customer" description:"业务范围类型 (platform:平台, shop:店铺, personal_customer:个人客户)"`
|
||
ScopeID string `json:"scope_id" query:"scope_id" description:"业务范围稳定ID"`
|
||
ResourceType string `json:"resource_type" query:"resource_type" description:"Resource Registry 注册类型"`
|
||
ResourceID string `json:"resource_id" query:"resource_id" description:"资源内部稳定ID"`
|
||
ResourceKey string `json:"resource_key" query:"resource_key" description:"资源业务稳定Key"`
|
||
RequestID string `json:"request_id" query:"request_id" description:"HTTP请求关联ID"`
|
||
CorrelationID string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// AuditEventIDParams 是审计事件详情路径参数。
|
||
type AuditEventIDParams struct {
|
||
EventID string `json:"event_id" path:"event_id" required:"true" description:"稳定审计事件ID"`
|
||
}
|
||
|
||
// AuditActorEventsRequest 是操作者行为时间线参数。
|
||
type AuditActorEventsRequest struct {
|
||
Kind string `json:"kind" path:"kind" required:"true" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
|
||
ID string `json:"id" path:"id" required:"true" description:"操作者稳定ID"`
|
||
Action string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
|
||
Result string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"事件结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
|
||
Risk string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
|
||
ResourceType string `json:"resource_type" query:"resource_type" description:"Resource Registry注册类型；直接使用事件resources或investigation_refs返回的resource_type"`
|
||
ResourceID string `json:"resource_id" query:"resource_id" description:"资源内部稳定ID"`
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// AuditResourceSearchRequest 是首批注册资源的精确搜索参数。
|
||
type AuditResourceSearchRequest struct {
|
||
ResourceType string `json:"resource_type" query:"resource_type" required:"true" enum:"iot_card,device,shop,order,refund" description:"资源类型 (iot_card:IoT卡, device:设备, shop:店铺, order:订单, refund:退款单)"`
|
||
Keyword string `json:"keyword" query:"keyword" required:"true" description:"精确业务标识；卡支持ICCID/VirtualNo，设备支持VirtualNo/IMEI/SN"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// AuditResourceTimelineRequest 是通用资源时间线参数。
|
||
type AuditResourceTimelineRequest struct {
|
||
ResourceType string `json:"resource_type" path:"resource_type" required:"true" description:"Resource Registry 注册类型"`
|
||
ResourceID string `json:"resource_id" path:"resource_id" required:"true" description:"资源内部稳定ID"`
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
|
||
Action string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
|
||
Result string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"事件结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// AuditRequestTimelineParams 是请求链路时间线的路径参数。
|
||
type AuditRequestTimelineParams struct {
|
||
RequestID string `json:"request_id" path:"request_id" required:"true" description:"HTTP请求关联ID，来自审计或外部集成节点，也可从Access Log粘贴"`
|
||
}
|
||
|
||
// AuditCorrelationTimelineParams 是业务关联时间线的路径参数。
|
||
type AuditCorrelationTimelineParams struct {
|
||
CorrelationID string `json:"correlation_id" path:"correlation_id" required:"true" description:"跨请求、异步任务和外部交互的稳定业务链路ID"`
|
||
}
|
||
|
||
// AuditFinanceTimelineRequest 是资金调查时间线的稳定业务筛选参数。
|
||
type AuditFinanceTimelineRequest struct {
|
||
ShopID uint `json:"shop_id" query:"shop_id" description:"店铺ID"`
|
||
WalletID uint `json:"wallet_id" query:"wallet_id" description:"代理或资产钱包ID"`
|
||
OrderID uint `json:"order_id" query:"order_id" description:"订单ID"`
|
||
OrderNo string `json:"order_no" query:"order_no" description:"订单编号"`
|
||
PaymentID uint `json:"payment_id" query:"payment_id" description:"支付记录ID"`
|
||
PaymentNo string `json:"payment_no" query:"payment_no" description:"支付单号"`
|
||
RefundID uint `json:"refund_id" query:"refund_id" description:"退款单ID"`
|
||
RefundNo string `json:"refund_no" query:"refund_no" description:"退款单号"`
|
||
RechargeID uint `json:"recharge_id" query:"recharge_id" description:"代理充值或个人资产充值ID"`
|
||
RechargeNo string `json:"recharge_no" query:"recharge_no" description:"充值单号"`
|
||
ApprovalInstanceID uint `json:"approval_instance_id" query:"approval_instance_id" description:"审批实例ID"`
|
||
ThirdPartyTradeNo string `json:"third_party_trade_no" query:"third_party_trade_no" description:"第三方交易号"`
|
||
ActorKind string `json:"actor_kind" query:"actor_kind" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型；与actor_id同时提供 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
|
||
ActorID string `json:"actor_id" query:"actor_id" description:"操作者稳定ID；与actor_kind同时提供"`
|
||
CorrelationID string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// AuditRiskFilterRequest 是风险总览和明细共用的受控筛选参数。
|
||
type AuditRiskFilterRequest struct {
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻，最长31天）；默认当前时间"`
|
||
Risk string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
|
||
Result string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
|
||
Action string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
|
||
Source string `json:"source" query:"source" enum:"admin_api,personal_api,openapi,worker,scheduler,callback" description:"来源 (admin_api:后台管理API, personal_api:个人客户API, openapi:代理OpenAPI, worker:异步Worker, scheduler:计划任务, callback:外部系统回调)"`
|
||
}
|
||
|
||
// AuditRiskOverviewRequest 是风险总览请求参数。
|
||
type AuditRiskOverviewRequest struct {
|
||
AuditRiskFilterRequest
|
||
}
|
||
|
||
// AuditRiskEventsRequest 是风险事件明细请求参数。
|
||
type AuditRiskEventsRequest struct {
|
||
AuditRiskFilterRequest
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// SubjectResourceActivityRequest 是代理安全资源活动的路径及分页参数。
|
||
type SubjectResourceActivityRequest struct {
|
||
ResourceType string `json:"resource_type" path:"resource_type" required:"true" enum:"iot_card,device,asset_allocation_record,exchange_order,shop,enterprise" description:"代理资源类型 (iot_card:IoT卡, device:设备, asset_allocation_record:资产分配记录, exchange_order:换货单, shop:店铺, enterprise:企业)"`
|
||
Identifier string `json:"identifier" path:"identifier" required:"true" description:"业务稳定标识；卡使用ICCID，设备使用VirtualNo，其他资源使用对应业务编号"`
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// EnterpriseResourceActivityRequest 是企业安全资源活动的路径及分页参数。
|
||
type EnterpriseResourceActivityRequest struct {
|
||
ResourceType string `json:"resource_type" path:"resource_type" required:"true" enum:"iot_card,device" description:"企业资源类型 (iot_card:IoT卡, device:设备)"`
|
||
Identifier string `json:"identifier" path:"identifier" required:"true" description:"业务稳定标识；卡使用ICCID，设备使用VirtualNo"`
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// IntegrationFilterRequest 是外部集成调查的公共受控筛选参数。
|
||
type IntegrationFilterRequest struct {
|
||
CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
|
||
CreatedTo string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
|
||
IntegrationID string `json:"integration_id" query:"integration_id" description:"稳定外部集成记录ID"`
|
||
Provider string `json:"provider" query:"provider" enum:"ctcc,cmcc,cucc,wechat_pay,alipay,fuiou,wecom,gateway" description:"外部服务提供方 (ctcc:中国电信, cmcc:中国移动, cucc:中国联通, wechat_pay:微信支付, alipay:支付宝, fuiou:富友, wecom:企业微信, gateway:设备网关)"`
|
||
Direction string `json:"direction" query:"direction" enum:"inbound,outbound" description:"交互方向 (inbound:入站, outbound:出站)"`
|
||
Operation string `json:"operation" query:"operation" enum:"realname_callback,realname_removal_callback,payment_precreate,payment_query,payment_callback,get_access_token,list_visible_members,list_visible_departments,get_template_detail,upload_approval_attachment,submit_approval,approval_callback,get_approval_detail,get_approval_info,query_realname_status,query_flow,query_card_status,query_device_info,set_speed_tier,stop_card,start_card,set_device_wifi,set_device_switch_mode,switch_device_card,reboot_device,reset_device" description:"外部操作稳定编码；直接使用列表或详情响应的operation，不按中文名称猜测"`
|
||
Result string `json:"result" query:"result" enum:"pending,success,failed,unknown,not_found,invalid_payload,conflict,ignored,merged,rate_limited,completed,cancelled" description:"原始结果 (pending:待处理, success:成功, failed:失败, unknown:结果未知, not_found:未找到, invalid_payload:无效载荷, conflict:冲突, ignored:已忽略, merged:已合并, rate_limited:已限频, completed:已提前完成, cancelled:已取消)"`
|
||
ResultCategory string `json:"result_category" query:"result_category" enum:"processing,succeeded,indeterminate,failed,not_sent" description:"派生结果类别 (processing:处理中, succeeded:成功, indeterminate:结果不确定, failed:失败, not_sent:未发送)"`
|
||
ExternalID string `json:"external_id" query:"external_id" description:"外部系统业务或请求标识"`
|
||
ResourceType string `json:"resource_type" query:"resource_type" description:"本地主要资源类型；直接使用列表resource.type或调查引用的resource_type"`
|
||
ResourceID string `json:"resource_id" query:"resource_id" description:"本地主要资源稳定ID"`
|
||
ResourceKey string `json:"resource_key" query:"resource_key" description:"本地主要资源稳定Key"`
|
||
TriggerSource string `json:"trigger_source" query:"trigger_source" description:"触发来源稳定编码"`
|
||
TriggerScene string `json:"trigger_scene" query:"trigger_scene" description:"触发业务场景"`
|
||
TriggerSeries string `json:"trigger_series" query:"trigger_series" description:"显式技术尝试序列ID"`
|
||
StateChanged *bool `json:"state_changed" query:"state_changed" description:"是否改变本地业务状态"`
|
||
HTTPStatus *int `json:"http_status" query:"http_status" minimum:"100" maximum:"599" description:"外部HTTP响应状态码"`
|
||
ProviderCode string `json:"provider_code" query:"provider_code" description:"外部服务稳定结果码"`
|
||
RequestID string `json:"request_id" query:"request_id" description:"来源HTTP请求ID"`
|
||
CorrelationID string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
|
||
}
|
||
|
||
// IntegrationOverviewRequest 是外部集成交互总览参数。
|
||
type IntegrationOverviewRequest struct {
|
||
IntegrationFilterRequest
|
||
Bucket string `json:"bucket" query:"bucket" enum:"hour,day" default:"hour" description:"趋势时间粒度 (hour:小时, day:自然日)"`
|
||
}
|
||
|
||
// IntegrationListRequest 是外部集成交互列表参数。
|
||
type IntegrationListRequest struct {
|
||
IntegrationFilterRequest
|
||
Page int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
|
||
}
|
||
|
||
// IntegrationIDParams 是外部集成详情路径参数。
|
||
type IntegrationIDParams struct {
|
||
IntegrationID string `json:"integration_id" path:"integration_id" required:"true" description:"稳定外部集成记录ID，来自列表、通知target_key或调查节点"`
|
||
}
|