f

internal/application/api/commands/api_call_commands.go

@@ -0,0 +1,71 @@
+package commands
+
+type ApiCallCommand struct {
+	ClientIP string         `json:"-"`
+	AccessId string         `json:"-"`
+	ApiName  string         `json:"-"`
+	Data     string         `json:"data" binding:"required"`
+	Options  ApiCallOptions `json:"options,omitempty"`
+}
+
+type ApiCallOptions struct {
+	Json    bool `json:"json,omitempty"`     // 是否返回JSON格式
+	IsDebug bool `json:"is_debug,omitempty"` // 是否为调试调用
+}
+
+// EncryptCommand 加密命令
+type EncryptCommand struct {
+	Data      map[string]interface{} `json:"data" binding:"required"`
+	SecretKey string                 `json:"secret_key" binding:"required"`
+}
+
+// DecryptCommand 解密命令
+type DecryptCommand struct {
+	EncryptedData string `json:"encrypted_data" binding:"required"`
+	SecretKey     string `json:"secret_key" binding:"required"`
+}
+
+// SaveApiCallCommand 保存API调用命令
+type SaveApiCallCommand struct {
+	ApiCallID     string  `json:"api_call_id"`
+	UserID        string  `json:"user_id"`
+	ProductID     string  `json:"product_id"`
+	TransactionID string  `json:"transaction_id"`
+	Status        string  `json:"status"`
+	Cost          float64 `json:"cost"`
+	ErrorType     string  `json:"error_type"`
+	ErrorMsg      string  `json:"error_msg"`
+	ClientIP      string  `json:"client_ip"`
+}
+
+// ProcessDeductionCommand 处理扣款命令
+type ProcessDeductionCommand struct {
+	UserID        string `json:"user_id"`
+	Amount        string `json:"amount"`
+	ApiCallID     string `json:"api_call_id"`
+	TransactionID string `json:"transaction_id"`
+	ProductID     string `json:"product_id"`
+}
+
+// UpdateUsageStatsCommand 更新使用统计命令
+type UpdateUsageStatsCommand struct {
+	SubscriptionID string `json:"subscription_id"`
+	UserID         string `json:"user_id"`
+	ProductID      string `json:"product_id"`
+	Increment      int    `json:"increment"`
+}
+
+// RecordApiLogCommand 记录API日志命令
+type RecordApiLogCommand struct {
+	TransactionID string `json:"transaction_id"`
+	UserID        string `json:"user_id"`
+	ApiName       string `json:"api_name"`
+	ClientIP      string `json:"client_ip"`
+	ResponseSize  int64  `json:"response_size"`
+}
+
+// ProcessCompensationCommand 处理补偿命令
+type ProcessCompensationCommand struct {
+	TransactionID string `json:"transaction_id"`
+	Type          string `json:"type"`
+}

internal/application/api/dto/api_call_validation.go

@@ -0,0 +1,104 @@
+package dto
+
+import (
+	api_entities "hyapi-server/internal/domains/api/entities"
+	product_entities "hyapi-server/internal/domains/product/entities"
+
+	"github.com/shopspring/decimal"
+)
+
+// ApiCallValidationResult API调用验证结果
+type ApiCallValidationResult struct {
+	UserID         string          `json:"user_id"`
+	ProductID      string          `json:"product_id"`
+	SubscriptionID string          `json:"subscription_id"`
+	Amount         decimal.Decimal `json:"amount"`
+	SecretKey      string          `json:"secret_key"`
+	IsValid        bool            `json:"is_valid"`
+	ErrorMessage   string          `json:"error_message"`
+
+	// 新增字段
+	ContractCode  string                         `json:"contract_code"`
+	ApiCall       *api_entities.ApiCall          `json:"api_call"`
+	RequestParams map[string]interface{}         `json:"request_params"`
+	Product       *product_entities.Product      `json:"product"`
+	Subscription  *product_entities.Subscription `json:"subscription"`
+}
+
+// GetUserID 获取用户ID
+func (r *ApiCallValidationResult) GetUserID() string {
+	return r.UserID
+}
+
+// GetProductID 获取产品ID
+func (r *ApiCallValidationResult) GetProductID() string {
+	return r.ProductID
+}
+
+// GetSubscriptionID 获取订阅ID
+func (r *ApiCallValidationResult) GetSubscriptionID() string {
+	return r.SubscriptionID
+}
+
+// GetAmount 获取金额
+func (r *ApiCallValidationResult) GetAmount() decimal.Decimal {
+	return r.Amount
+}
+
+// GetSecretKey 获取密钥
+func (r *ApiCallValidationResult) GetSecretKey() string {
+	return r.SecretKey
+}
+
+// IsValidResult 检查是否有效
+func (r *ApiCallValidationResult) IsValidResult() bool {
+	return r.IsValid
+}
+
+// GetErrorMessage 获取错误消息
+func (r *ApiCallValidationResult) GetErrorMessage() string {
+	return r.ErrorMessage
+}
+
+// NewApiCallValidationResult 创建新的API调用验证结果
+func NewApiCallValidationResult() *ApiCallValidationResult {
+	return &ApiCallValidationResult{
+		IsValid:       true,
+		RequestParams: make(map[string]interface{}),
+	}
+}
+
+// SetApiUser 设置API用户
+func (r *ApiCallValidationResult) SetApiUser(apiUser *api_entities.ApiUser) {
+	r.UserID = apiUser.UserId
+	r.SecretKey = apiUser.SecretKey
+}
+
+// SetProduct 设置产品
+func (r *ApiCallValidationResult) SetProduct(product *product_entities.Product) {
+	r.ProductID = product.ID
+	r.Product = product
+	// 注意：这里不设置Amount，应该通过SetSubscription来设置实际的扣费金额
+}
+
+// SetApiCall 设置API调用
+func (r *ApiCallValidationResult) SetApiCall(apiCall *api_entities.ApiCall) {
+	r.ApiCall = apiCall
+}
+
+// SetRequestParams 设置请求参数
+func (r *ApiCallValidationResult) SetRequestParams(params map[string]interface{}) {
+	r.RequestParams = params
+}
+
+// SetContractCode 设置合同代码
+func (r *ApiCallValidationResult) SetContractCode(code string) {
+	r.ContractCode = code
+}
+
+// SetSubscription 设置订阅信息（包含实际扣费金额）
+func (r *ApiCallValidationResult) SetSubscription(subscription *product_entities.Subscription) {
+	r.SubscriptionID = subscription.ID
+	r.Amount = subscription.Price // 使用订阅价格作为扣费金额
+	r.Subscription = subscription
+}

internal/application/api/dto/api_response.go

@@ -0,0 +1,103 @@
+package dto
+
+import "time"
+
+// ApiCallResponse API调用响应结构
+type ApiCallResponse struct {
+	Code          int    `json:"code"`
+	Message       string `json:"message"`
+	TransactionId string `json:"transaction_id"`
+	Data          string `json:"data,omitempty"`
+}
+
+// ApiKeysResponse API密钥响应结构
+type ApiKeysResponse struct {
+	ID        string    `json:"id"`
+	UserID    string    `json:"user_id"`
+	AccessID  string    `json:"access_id"`
+	SecretKey string    `json:"secret_key"`
+	Status    string    `json:"status"`
+	CreatedAt time.Time `json:"created_at"`
+	UpdatedAt time.Time `json:"updated_at"`
+}
+
+// 白名单相关DTO
+type WhiteListResponse struct {
+	ID        string    `json:"id"`
+	UserID    string    `json:"user_id"`
+	IPAddress string    `json:"ip_address"`
+	Remark    string    `json:"remark"` // 备注
+	CreatedAt time.Time `json:"created_at"`
+}
+
+type WhiteListRequest struct {
+	IPAddress string `json:"ip_address" binding:"required,ip"`
+	Remark    string `json:"remark"` // 备注（可选）
+}
+
+type WhiteListListResponse struct {
+	Items []WhiteListResponse `json:"items"`
+	Total int                 `json:"total"`
+}
+
+// API调用记录相关DTO
+type ApiCallRecordResponse struct {
+	ID                 string              `json:"id"`
+	AccessId           string              `json:"access_id"`
+	UserId             string              `json:"user_id"`
+	ProductId          *string             `json:"product_id,omitempty"`
+	ProductName        *string             `json:"product_name,omitempty"`
+	TransactionId      string              `json:"transaction_id"`
+	ClientIp           string              `json:"client_ip"`
+	RequestParams      string              `json:"request_params"`
+	Status             string              `json:"status"`
+	StartAt            string              `json:"start_at"`
+	EndAt              *string             `json:"end_at,omitempty"`
+	Cost               *string             `json:"cost,omitempty"`
+	ErrorType          *string             `json:"error_type,omitempty"`
+	ErrorMsg           *string             `json:"error_msg,omitempty"`
+	TranslatedErrorMsg *string             `json:"translated_error_msg,omitempty"`
+	CompanyName        *string             `json:"company_name,omitempty"`
+	User               *UserSimpleResponse `json:"user,omitempty"`
+	CreatedAt          string              `json:"created_at"`
+	UpdatedAt          string              `json:"updated_at"`
+}
+
+// UserSimpleResponse 用户简单信息响应
+type UserSimpleResponse struct {
+	ID          string `json:"id"`
+	CompanyName string `json:"company_name"`
+	Phone       string `json:"phone"`
+}
+
+type ApiCallListResponse struct {
+	Items []ApiCallRecordResponse `json:"items"`
+	Total int64                   `json:"total"`
+	Page  int                     `json:"page"`
+	Size  int                     `json:"size"`
+}
+
+// EncryptResponse 加密响应
+type EncryptResponse struct {
+	EncryptedData string `json:"encrypted_data"`
+}
+
+// NewSuccessResponse 创建成功响应
+func NewSuccessResponse(transactionId, data string) *ApiCallResponse {
+	return &ApiCallResponse{
+		Code:          0,
+		Message:       "业务成功",
+		TransactionId: transactionId,
+		Data:          data,
+	}
+}
+
+// NewErrorResponse 创建错误响应
+func NewErrorResponse(code int, message, transactionId string) *ApiCallResponse {
+	return &ApiCallResponse{
+		Code:          code,
+		Message:       message,
+		TransactionId: transactionId,
+		Data:          "",
+	}
+}

internal/application/api/dto/form_config_dto.go

@@ -0,0 +1,19 @@
+package dto
+
+// FormField 表单字段配置
+type FormField struct {
+	Name        string `json:"name"`
+	Label       string `json:"label"`
+	Type        string `json:"type"`
+	Required    bool   `json:"required"`
+	Validation  string `json:"validation"`
+	Description string `json:"description"`
+	Example     string `json:"example"`
+	Placeholder string `json:"placeholder"`
+}
+
+// FormConfigResponse 表单配置响应
+type FormConfigResponse struct {
+	ApiCode string       `json:"api_code"`
+	Fields  []FormField `json:"fields"`
+}

internal/application/api/errors.go

@@ -0,0 +1,61 @@
+package api
+
+import "errors"
+
+// API调用相关错误类型
+var (
+	ErrQueryEmpty           = errors.New("查询为空")
+	ErrSystem               = errors.New("接口异常")
+	ErrDecryptFail          = errors.New("解密失败")
+	ErrRequestParam         = errors.New("请求参数结构不正确")
+	ErrInvalidParam         = errors.New("参数校验不正确")
+	ErrInvalidIP            = errors.New("未经授权的IP")
+	ErrMissingAccessId      = errors.New("缺少Access-Id")
+	ErrInvalidAccessId      = errors.New("未经授权的AccessId")
+	ErrFrozenAccount        = errors.New("账户已冻结")
+	ErrArrears              = errors.New("账户余额不足，无法请求")
+	ErrInsufficientBalance  = errors.New("钱包余额不足")
+	ErrProductNotFound      = errors.New("产品不存在")
+	ErrProductDisabled      = errors.New("产品已停用")
+	ErrNotSubscribed        = errors.New("未订阅此产品")
+	ErrProductNotSubscribed = errors.New("未订阅此产品")
+	ErrSubscriptionExpired  = errors.New("订阅已过期")
+	ErrSubscriptionSuspended = errors.New("订阅已暂停")
+	ErrBusiness             = errors.New("业务失败")
+)
+
+// 错误码映射 - 严格按照用户要求
+var ErrorCodeMap = map[error]int{
+	ErrQueryEmpty:           1000,
+	ErrSystem:               1001,
+	ErrDecryptFail:          1002,
+	ErrRequestParam:         1003,
+	ErrInvalidParam:         1003,
+	ErrInvalidIP:            1004,
+	ErrMissingAccessId:      1005,
+	ErrInvalidAccessId:      1006,
+	ErrFrozenAccount:        1007,
+	ErrArrears:              1007,
+	ErrInsufficientBalance:  1007,
+	ErrProductNotFound:      1008,
+	ErrProductDisabled:      1008,
+	ErrNotSubscribed:        1008,
+	ErrProductNotSubscribed: 1008,
+	ErrSubscriptionExpired:  1008,
+	ErrSubscriptionSuspended: 1008,
+	ErrBusiness:             2001,
+}
+
+// GetErrorCode 获取错误对应的错误码
+func GetErrorCode(err error) int {
+	if code, exists := ErrorCodeMap[err]; exists {
+		return code
+	}
+	return 1001 // 默认返回接口异常
+}
+
+// GetErrorMessage 获取错误对应的错误消息
+func GetErrorMessage(err error) string {
+	// 直接返回预定义的错误消息
+	return err.Error()
+}

internal/application/api/utils/error_translator.go

@@ -0,0 +1,40 @@
+package utils
+
+// TranslateErrorMsg 翻译错误信息
+func TranslateErrorMsg(errorType, errorMsg *string) *string {
+	if errorType == nil || errorMsg == nil {
+		return nil
+	}
+
+	// 错误类型到中文描述的映射
+	errorTypeTranslations := map[string]string{
+		"invalid_access":    "无效的访问凭证",
+		"frozen_account":    "账户已被冻结",
+		"invalid_ip":        "IP地址未授权",
+		"arrears":           "账户余额不足",
+		"not_subscribed":    "未订阅该产品",
+		"product_not_found": "产品不存在",
+		"product_disabled":  "产品已停用",
+		"system_error":      "接口异常",
+		"datasource_error":  "数据源异常",
+		"invalid_param":     "参数校验失败",
+		"decrypt_fail":      "参数解密失败",
+		"query_empty":       "查询结果为空",
+	}
+
+	// 获取错误类型的中文描述
+	translatedType, exists := errorTypeTranslations[*errorType]
+	if !exists {
+		// 如果没有找到对应的翻译，返回原始错误信息
+		return errorMsg
+	}
+
+	// 构建翻译后的错误信息
+	translatedMsg := translatedType
+	if *errorMsg != "" && *errorMsg != *errorType {
+		// 如果原始错误信息不是错误类型本身，则组合显示
+		translatedMsg = translatedType + "：" + *errorMsg
+	}
+
+	return &translatedMsg
+}