f

app/main/api/desc/admin/admin_query_whitelist.api

@@ -0,0 +1,80 @@
+syntax = "v1"
+
+info (
+	title:   "查询白名单管理"
+	desc:    "代理天远查询白名单接口，并记录操作日志"
+	version: "v1"
+)
+
+@server (
+	prefix: /api/v1/admin/query-whitelist
+	group:  admin_query_whitelist
+	middleware: AdminAuthInterceptor
+)
+service main {
+	// 创建规则（代理天远 /entries）
+	@handler AdminQueryWhitelistCreate
+	post /create (AdminQueryWhitelistCreateReq) returns (AdminQueryWhitelistOpResp)
+
+	// 追加接口（代理天远 /entries/append）
+	@handler AdminQueryWhitelistAppend
+	post /append (AdminQueryWhitelistAppendReq) returns (AdminQueryWhitelistOpResp)
+
+	// 操作记录分页列表
+	@handler AdminQueryWhitelistOpLogList
+	get /op-log/list (AdminQueryWhitelistOpLogListReq) returns (AdminQueryWhitelistOpLogListResp)
+}
+
+type (
+	AdminQueryWhitelistCreateReq {
+		Name     string   `json:"name"`                // 姓名，* 表示只按身份证匹配
+		IdCard   string   `json:"id_card"`             // 18位身份证号
+		ApiCodes []string `json:"api_codes"`           // 产品编码列表
+		Remark   string   `json:"remark,optional"`     // 备注
+	}
+	AdminQueryWhitelistAppendReq {
+		Name     string   `json:"name"`                // 姓名，* 表示只按身份证匹配
+		IdCard   string   `json:"id_card"`             // 18位身份证号
+		ApiCodes []string `json:"api_codes"`           // 产品编码列表
+		Remark   string   `json:"remark,optional"`     // 备注
+	}
+	AdminQueryWhitelistOpResp {
+		Success         bool     `json:"success"`                    // 天远是否业务成功
+		TianyuanCode    int      `json:"tianyuan_code"`              // 天远业务码
+		TianyuanMessage string   `json:"tianyuan_message"`           // 天远返回描述
+		TransactionId   string   `json:"transaction_id,optional"`    // 天远流水号
+		EntryId         string   `json:"entry_id,optional"`          // 规则ID
+		IdCardMasked    string   `json:"id_card_masked,optional"`    // 脱敏身份证号
+		EntryApiCodes   []string `json:"entry_api_codes,optional"`   // 规则当前产品编码
+		EntryStatus     string   `json:"entry_status,optional"`      // 规则状态
+	}
+	AdminQueryWhitelistOpLogListReq {
+		Page         int64   `form:"page,default=1"`
+		PageSize     int64   `form:"pageSize,default=20"`
+		IdCard       *string `form:"id_card,optional"`
+		Action       *string `form:"action,optional"`
+		TianyuanCode *int    `form:"tianyuan_code,optional"`
+	}
+	QueryWhitelistOpLogItem {
+		Id              int64    `json:"id"`
+		AdminUserId     int64    `json:"admin_user_id"`
+		AdminUserName   string   `json:"admin_user_name"`
+		Action          string   `json:"action"`
+		Name            string   `json:"name"`
+		IdCard          string   `json:"id_card"`
+		IdCardMasked    string   `json:"id_card_masked"`
+		ApiCodes        []string `json:"api_codes"`
+		Remark          string   `json:"remark"`
+		TianyuanCode    int      `json:"tianyuan_code"`
+		TianyuanMessage string   `json:"tianyuan_message"`
+		TransactionId   string   `json:"transaction_id"`
+		EntryId         string   `json:"entry_id"`
+		EntryStatus     string   `json:"entry_status"`
+		EntryApiCodes   []string `json:"entry_api_codes"`
+		CreateTime      string   `json:"create_time"`
+	}
+	AdminQueryWhitelistOpLogListResp {
+		Total int64                     `json:"total"`
+		Items []QueryWhitelistOpLogItem `json:"items"`
+	}
+)