支撑单卡

2026-06-04 14:29:20 +08:00
parent cce27975a1
commit 6ac19d6565
3 changed files with 40 additions and 11 deletions
--- a/internal/routes/open.go
+++ b/internal/routes/open.go
@@ -74,8 +74,8 @@ function buildAgentSign({ method, path, query, body, timestamp, nonce, account,
 ` + "```"

 	Register(router, doc, basePath, "GET", "/cards/traffic", handler.GetCardTraffic, RouteSpec{
-		Summary:        "查询单卡流量",
-		Description:    authDescription + "\n\n按 card_no 查询单卡流量、当前套餐和待生效套餐。card_no 支持 ICCID、虚拟号、MSISDN。",
+		Summary:        "查询单卡或设备流量",
+		Description:    authDescription + "\n\n按 card_no 查询流量、当前套餐和待生效套餐。card_no 支持三种解析路径：1) ICCID/虚拟号/MSISDN 对应独立卡，查卡维度流量；2) 已绑定设备的卡，自动反查绑定设备，查设备维度流量（响应含 device_no）；3) IMEI 或设备虚拟号，直接查设备维度流量（响应含 device_no）。",
 		Input:          new(dto.AgentOpenAPICardQueryRequest),
 		Output:         new(dto.AgentOpenAPICardTrafficResponse),
 		Tags:           []string{tag},