basePath: / definitions: commands.AddPackageItemCommand: properties: product_id: type: string required: - product_id type: object commands.ApiCallCommand: properties: data: type: string options: $ref: '#/definitions/commands.ApiCallOptions' required: - data type: object commands.ApiCallOptions: properties: is_debug: description: 是否为调试调用 type: boolean json: description: 是否返回JSON格式 type: boolean type: object commands.ApplyContractCommand: properties: user_id: type: string required: - user_id type: object commands.BatchUpdateSubscriptionPricesCommand: properties: discount: maximum: 10 minimum: 0.1 type: number scope: enum: - undiscounted - all type: string user_id: type: string required: - discount - scope - user_id type: object commands.ChangePasswordCommand: description: 修改用户密码请求参数 properties: code: example: "123456" type: string confirm_new_password: example: NewPassword123 type: string new_password: example: NewPassword123 type: string old_password: example: OldPassword123 maxLength: 128 minLength: 6 type: string required: - code - confirm_new_password - new_password - old_password type: object commands.CreateAlipayRechargeCommand: properties: amount: description: 充值金额 type: string platform: description: 支付平台：app/h5/pc enum: - app - h5 - pc type: string required: - amount - platform type: object commands.CreateArticleCommand: properties: category_id: type: string content: type: string cover_image: type: string is_featured: type: boolean summary: type: string tag_ids: items: type: string type: array title: type: string required: - content - title type: object commands.CreateCategoryCommand: properties: code: type: string description: maxLength: 200 type: string is_enabled: type: boolean is_visible: type: boolean name: maxLength: 50 minLength: 2 type: string sort: maximum: 9999 minimum: 0 type: integer required: - code - name type: object commands.CreateDocumentationCommand: properties: basic_info: type: string error_codes: type: string product_id: type: string request_method: type: string request_params: type: string request_url: type: string response_example: type: string response_fields: type: string required: - basic_info - product_id - request_method - request_params - request_url type: object commands.CreateProductCommand: properties: category_id: type: string code: type: string content: maxLength: 5000 type: string description: maxLength: 500 type: string is_enabled: type: boolean is_package: type: boolean is_visible: type: boolean name: maxLength: 100 minLength: 2 type: string price: minimum: 0 type: number seo_description: maxLength: 200 type: string seo_keywords: maxLength: 200 type: string seo_title: description: SEO信息 maxLength: 100 type: string required: - category_id - code - name type: object commands.DecryptCommand: properties: encrypted_data: type: string secret_key: type: string required: - encrypted_data - secret_key type: object commands.EncryptCommand: properties: data: additionalProperties: true type: object secret_key: type: string required: - data - secret_key type: object commands.LoginWithPasswordCommand: description: 使用密码进行用户登录请求参数 properties: password: example: Password123 maxLength: 128 minLength: 6 type: string phone: example: "13800138000" type: string required: - password - phone type: object commands.LoginWithSMSCommand: description: 使用短信验证码进行用户登录请求参数 properties: code: example: "123456" type: string phone: example: "13800138000" type: string required: - code - phone type: object commands.PackageItemData: properties: product_id: type: string sort_order: minimum: 0 type: integer required: - product_id - sort_order type: object commands.RegisterUserCommand: description: 用户注册请求参数 properties: code: example: "123456" type: string confirm_password: example: Password123 type: string password: example: Password123 type: string phone: example: "13800138000" type: string required: - code - confirm_password - password - phone type: object commands.ReorderPackageItemsCommand: properties: item_ids: items: type: string type: array required: - item_ids type: object commands.ResetPasswordCommand: description: 重置用户密码请求参数（忘记密码时使用） properties: code: example: "123456" type: string confirm_new_password: example: NewPassword123 type: string new_password: example: NewPassword123 type: string phone: example: "13800138000" type: string required: - code - confirm_new_password - new_password - phone type: object commands.SendCodeCommand: description: 发送短信验证码请求参数 properties: phone: example: "13800138000" type: string scene: enum: - register - login - change_password - reset_password - bind - unbind - certification example: register type: string required: - phone - scene type: object commands.SetFeaturedCommand: properties: is_featured: type: boolean required: - is_featured type: object commands.SubmitEnterpriseInfoCommand: properties: company_name: maxLength: 100 minLength: 2 type: string enterprise_address: type: string legal_person_id: type: string legal_person_name: maxLength: 20 minLength: 2 type: string legal_person_phone: type: string unified_social_code: type: string verification_code: type: string required: - company_name - enterprise_address - legal_person_id - legal_person_name - legal_person_phone - unified_social_code - verification_code type: object commands.UpdateArticleCommand: properties: category_id: type: string content: type: string cover_image: type: string is_featured: type: boolean summary: type: string tag_ids: items: type: string type: array title: type: string type: object commands.UpdateCategoryCommand: properties: code: type: string description: maxLength: 200 type: string is_enabled: type: boolean is_visible: type: boolean name: maxLength: 50 minLength: 2 type: string sort: maximum: 9999 minimum: 0 type: integer required: - code - name type: object commands.UpdatePackageItemCommand: properties: sort_order: minimum: 0 type: integer required: - sort_order type: object commands.UpdatePackageItemsCommand: properties: items: items: $ref: '#/definitions/commands.PackageItemData' type: array required: - items type: object commands.UpdateProductCommand: properties: category_id: type: string code: type: string content: maxLength: 5000 type: string description: maxLength: 500 type: string is_enabled: type: boolean is_package: type: boolean is_visible: type: boolean name: maxLength: 100 minLength: 2 type: string price: minimum: 0 type: number seo_description: maxLength: 200 type: string seo_keywords: maxLength: 200 type: string seo_title: description: SEO信息 maxLength: 100 type: string required: - category_id - code - name type: object commands.UpdateSubscriptionPriceCommand: properties: price: minimum: 0 type: number type: object dto.ApiCallListResponse: properties: items: items: $ref: '#/definitions/dto.ApiCallRecordResponse' type: array page: type: integer size: type: integer total: type: integer type: object dto.ApiCallRecordResponse: properties: access_id: type: string client_ip: type: string company_name: type: string cost: type: string created_at: type: string end_at: type: string error_msg: type: string error_type: type: string id: type: string product_id: type: string product_name: type: string start_at: type: string status: type: string transaction_id: type: string translated_error_msg: type: string updated_at: type: string user: $ref: '#/definitions/dto.UserSimpleResponse' user_id: type: string type: object dto.ApiCallResponse: properties: code: type: integer data: type: string message: type: string transaction_id: type: string type: object dto.AvailableAmountResponse: properties: available_amount: description: 可开票金额 type: number pending_applications: description: 待处理申请金额 type: number total_gifted: description: 总赠送金额 type: number total_invoiced: description: 已开票金额 type: number total_recharged: description: 总充值金额 type: number type: object dto.EncryptResponse: properties: encrypted_data: type: string type: object dto.InvoiceApplicationResponse: properties: amount: type: number created_at: type: string id: type: string invoice_info: $ref: '#/definitions/value_objects.InvoiceInfo' invoice_type: $ref: '#/definitions/value_objects.InvoiceType' status: $ref: '#/definitions/entities.ApplicationStatus' user_id: type: string type: object dto.InvoiceInfoResponse: properties: bank_account: description: 用户可编辑 type: string bank_name: description: 用户可编辑 type: string company_address: description: 用户可编辑 type: string company_name: description: 从企业认证信息获取，只读 type: string company_name_read_only: description: 字段权限标识 type: boolean company_phone: description: 用户可编辑 type: string is_complete: type: boolean missing_fields: items: type: string type: array receiving_email: description: 用户可编辑 type: string taxpayer_id: description: 从企业认证信息获取，只读 type: string taxpayer_id_read_only: description: 纳税人识别号是否只读 type: boolean type: object dto.InvoiceRecordResponse: properties: amount: type: number bank_account: description: 银行账号 type: string bank_name: description: 开户银行 type: string company_address: description: 企业地址 type: string company_name: description: 开票信息（快照数据） type: string company_phone: description: 企业电话 type: string created_at: type: string file_name: description: 文件信息 type: string file_size: type: integer file_url: type: string id: type: string invoice_type: $ref: '#/definitions/value_objects.InvoiceType' processed_at: description: 时间信息 type: string receiving_email: description: 接收邮箱 type: string reject_reason: description: 拒绝原因 type: string status: $ref: '#/definitions/entities.ApplicationStatus' taxpayer_id: description: 纳税人识别号 type: string user_id: type: string type: object dto.InvoiceRecordsResponse: properties: page: type: integer page_size: type: integer records: items: $ref: '#/definitions/dto.InvoiceRecordResponse' type: array total: type: integer total_pages: type: integer type: object dto.PendingApplicationResponse: properties: amount: type: number bank_account: type: string bank_name: type: string company_address: type: string company_name: type: string company_phone: type: string created_at: type: string file_name: type: string file_size: type: integer file_url: type: string id: type: string invoice_type: $ref: '#/definitions/value_objects.InvoiceType' processed_at: type: string receiving_email: type: string reject_reason: type: string status: $ref: '#/definitions/entities.ApplicationStatus' taxpayer_id: type: string user_id: type: string type: object dto.PendingApplicationsResponse: properties: applications: items: $ref: '#/definitions/dto.PendingApplicationResponse' type: array page: type: integer page_size: type: integer total: type: integer total_pages: type: integer type: object dto.UserSimpleResponse: properties: company_name: type: string id: type: string phone: type: string type: object entities.ApplicationStatus: enum: - pending - completed - rejected type: string x-enum-comments: ApplicationStatusCompleted: 已完成（已上传发票） ApplicationStatusPending: 待处理 ApplicationStatusRejected: 已拒绝 x-enum-descriptions: - 待处理 - 已完成（已上传发票） - 已拒绝 x-enum-varnames: - ApplicationStatusPending - ApplicationStatusCompleted - ApplicationStatusRejected enums.CertificationStatus: enum: - pending - info_submitted - enterprise_verified - contract_applied - contract_signed - completed - info_rejected - contract_rejected - contract_expired type: string x-enum-comments: StatusCompleted: 认证完成 StatusContractApplied: 已申请签署合同 StatusContractExpired: 合同签署超时 StatusContractRejected: 合同被拒签 StatusContractSigned: 已签署合同 StatusEnterpriseVerified: 已企业认证 StatusInfoRejected: 企业信息被拒绝 StatusInfoSubmitted: 已提交企业信息 StatusPending: 待认证 x-enum-descriptions: - 待认证 - 已提交企业信息 - 已企业认证 - 已申请签署合同 - 已签署合同 - 认证完成 - 企业信息被拒绝 - 合同被拒签 - 合同签署超时 x-enum-varnames: - StatusPending - StatusInfoSubmitted - StatusEnterpriseVerified - StatusContractApplied - StatusContractSigned - StatusCompleted - StatusInfoRejected - StatusContractRejected - StatusContractExpired enums.FailureReason: enum: - enterprise_not_exists - enterprise_info_mismatch - enterprise_status_abnormal - legal_person_mismatch - esign_verification_failed - invalid_document - contract_rejected_by_user - contract_expired - sign_process_failed - contract_gen_failed - esign_flow_error - system_error - network_error - timeout - unknown_error type: string x-enum-comments: FailureReasonContractExpired: 合同签署超时 FailureReasonContractGenFailed: 合同生成失败 FailureReasonContractRejectedByUser: 用户拒绝签署 FailureReasonEnterpriseInfoMismatch: 企业信息不匹配 FailureReasonEnterpriseNotExists: 企业不存在 FailureReasonEnterpriseStatusAbnormal: 企业状态异常 FailureReasonEsignFlowError: e签宝流程错误 FailureReasonEsignVerificationFailed: e签宝验证失败 FailureReasonInvalidDocument: 证件信息无效 FailureReasonLegalPersonMismatch: 法定代表人信息不匹配 FailureReasonNetworkError: 网络错误 FailureReasonSignProcessFailed: 签署流程失败 FailureReasonSystemError: 系统错误 FailureReasonTimeout: 操作超时 FailureReasonUnknownError: 未知错误 x-enum-descriptions: - 企业不存在 - 企业信息不匹配 - 企业状态异常 - 法定代表人信息不匹配 - e签宝验证失败 - 证件信息无效 - 用户拒绝签署 - 合同签署超时 - 签署流程失败 - 合同生成失败 - e签宝流程错误 - 系统错误 - 网络错误 - 操作超时 - 未知错误 x-enum-varnames: - FailureReasonEnterpriseNotExists - FailureReasonEnterpriseInfoMismatch - FailureReasonEnterpriseStatusAbnormal - FailureReasonLegalPersonMismatch - FailureReasonEsignVerificationFailed - FailureReasonInvalidDocument - FailureReasonContractRejectedByUser - FailureReasonContractExpired - FailureReasonSignProcessFailed - FailureReasonContractGenFailed - FailureReasonEsignFlowError - FailureReasonSystemError - FailureReasonNetworkError - FailureReasonTimeout - FailureReasonUnknownError finance.ApplyInvoiceRequest: properties: amount: description: 开票金额 type: string invoice_type: description: 发票类型：general/special type: string required: - amount - invoice_type type: object finance.RejectInvoiceRequest: properties: reason: description: 拒绝原因 type: string required: - reason type: object finance.UpdateInvoiceInfoRequest: properties: bank_account: description: 银行账户 type: string bank_name: description: 银行名称 type: string company_address: description: 公司地址 type: string company_name: description: 公司名称（从企业认证信息获取，用户不可修改） type: string company_phone: description: 企业注册电话 type: string receiving_email: description: 发票接收邮箱 type: string taxpayer_id: description: 纳税人识别号（从企业认证信息获取，用户不可修改） type: string required: - receiving_email type: object interfaces.APIResponse: properties: data: {} errors: {} message: type: string meta: additionalProperties: true type: object pagination: $ref: '#/definitions/interfaces.PaginationMeta' request_id: type: string success: type: boolean timestamp: type: integer type: object interfaces.PaginationMeta: properties: has_next: type: boolean has_prev: type: boolean page: type: integer page_size: type: integer total: type: integer total_pages: type: integer type: object queries.ConfirmAuthCommand: type: object queries.ConfirmSignCommand: type: object responses.AlipayOrderStatusResponse: properties: amount: description: 订单金额 type: number can_retry: description: 是否可以重试 type: boolean created_at: description: 创建时间 type: string error_code: description: 错误码 type: string error_message: description: 错误信息 type: string is_processing: description: 是否处理中 type: boolean notify_time: description: 异步通知时间 type: string out_trade_no: description: 商户订单号 type: string platform: description: 支付平台 type: string return_time: description: 同步返回时间 type: string status: description: 订单状态 type: string subject: description: 订单标题 type: string trade_no: description: 支付宝交易号 type: string updated_at: description: 更新时间 type: string type: object responses.AlipayRechargeBonusRuleResponse: properties: bonus_amount: type: number recharge_amount: type: number type: object responses.AlipayRechargeOrderResponse: properties: amount: description: 充值金额 type: number out_trade_no: description: 商户订单号 type: string pay_url: description: 支付链接 type: string platform: description: 支付平台 type: string subject: description: 订单标题 type: string type: object responses.ArticleInfoResponse: properties: category: $ref: '#/definitions/tyapi-server_internal_application_article_dto_responses.CategoryInfoResponse' category_id: type: string content: type: string cover_image: type: string created_at: type: string id: type: string is_featured: type: boolean published_at: type: string status: type: string summary: type: string tags: items: $ref: '#/definitions/responses.TagInfoResponse' type: array title: type: string updated_at: type: string view_count: type: integer type: object responses.ArticleListResponse: properties: items: items: $ref: '#/definitions/responses.ArticleInfoResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.ArticleStatsResponse: properties: archived_articles: type: integer draft_articles: type: integer published_articles: type: integer total_articles: type: integer total_views: type: integer type: object responses.CategoryListResponse: properties: items: items: $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.CategorySimpleResponse: properties: code: type: string id: type: string name: type: string type: object responses.CertificationListResponse: properties: items: items: $ref: '#/definitions/responses.CertificationResponse' type: array page: type: integer page_size: type: integer total: type: integer total_pages: type: integer type: object responses.CertificationResponse: properties: available_actions: items: type: string type: array can_retry: type: boolean completed_at: type: string contract_applied_at: type: string contract_info: allOf: - $ref: '#/definitions/value_objects.ContractInfo' description: 合同信息 contract_signed_at: type: string created_at: description: 时间戳 type: string enterprise_info: allOf: - $ref: '#/definitions/value_objects.EnterpriseInfo' description: 企业信息 enterprise_verified_at: type: string failure_message: type: string failure_reason: allOf: - $ref: '#/definitions/enums.FailureReason' description: 失败信息 failure_reason_name: type: string id: type: string info_submitted_at: type: string is_completed: description: 业务状态 type: boolean is_failed: type: boolean is_user_action_required: type: boolean metadata: additionalProperties: true description: 元数据 type: object next_action: description: 用户操作提示 type: string progress: type: integer retry_count: type: integer status: $ref: '#/definitions/enums.CertificationStatus' status_name: type: string updated_at: type: string user_id: type: string type: object responses.ConfirmAuthResponse: properties: reason: type: string status: $ref: '#/definitions/enums.CertificationStatus' type: object responses.ConfirmSignResponse: properties: reason: type: string status: $ref: '#/definitions/enums.CertificationStatus' type: object responses.ContractInfoItem: properties: contract_file_url: type: string contract_name: type: string contract_type: description: 合同类型代码 type: string contract_type_name: description: 合同类型中文名称 type: string created_at: type: string id: type: string type: object responses.ContractSignUrlResponse: properties: certification_id: type: string contract_sign_url: type: string contract_url: type: string expire_at: type: string message: type: string next_action: type: string type: object responses.DocumentationResponse: properties: basic_info: type: string created_at: type: string error_codes: type: string id: type: string product_id: type: string request_method: type: string request_params: type: string request_url: type: string response_example: type: string response_fields: type: string updated_at: type: string version: type: string type: object responses.EnterpriseInfoItem: properties: company_name: type: string contracts: description: 合同信息 items: $ref: '#/definitions/responses.ContractInfoItem' type: array created_at: type: string enterprise_address: type: string id: type: string legal_person_name: type: string legal_person_phone: type: string unified_social_code: type: string type: object responses.EnterpriseInfoResponse: description: 企业信息响应 properties: certified_at: example: "2024-01-01T00:00:00Z" type: string company_name: example: 示例企业有限公司 type: string created_at: example: "2024-01-01T00:00:00Z" type: string enterprise_address: example: 北京市朝阳区xxx街道xxx号 type: string id: example: 123e4567-e89b-12d3-a456-426614174000 type: string legal_person_id: example: "110101199001011234" type: string legal_person_name: example: 张三 type: string legal_person_phone: example: "13800138000" type: string unified_social_code: example: 91110000123456789X type: string updated_at: example: "2024-01-01T00:00:00Z" type: string type: object responses.LoginUserResponse: description: 用户登录成功响应 properties: access_token: example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... type: string expires_in: example: 86400 type: integer login_method: example: password type: string token_type: example: Bearer type: string user: $ref: '#/definitions/responses.UserProfileResponse' type: object responses.PackageItemResponse: properties: id: type: string price: type: number product_code: type: string product_id: type: string product_name: type: string sort_order: type: integer type: object responses.ProductAdminInfoResponse: properties: category: allOf: - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' description: 关联信息 category_id: type: string code: type: string content: type: string created_at: type: string description: type: string documentation: allOf: - $ref: '#/definitions/responses.DocumentationResponse' description: 文档信息 id: type: string is_enabled: type: boolean is_package: type: boolean is_visible: type: boolean name: type: string old_id: type: string package_items: description: 组合包信息 items: $ref: '#/definitions/responses.PackageItemResponse' type: array price: type: number seo_description: type: string seo_keywords: type: string seo_title: description: SEO信息 type: string updated_at: type: string type: object responses.ProductAdminListResponse: properties: items: items: $ref: '#/definitions/responses.ProductAdminInfoResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.ProductApiConfigResponse: properties: created_at: type: string id: type: string product_id: type: string request_params: items: $ref: '#/definitions/responses.RequestParamResponse' type: array response_example: additionalProperties: true type: object response_fields: items: $ref: '#/definitions/responses.ResponseFieldResponse' type: array updated_at: type: string type: object responses.ProductInfoResponse: properties: category: allOf: - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' description: 关联信息 category_id: type: string code: type: string content: type: string created_at: type: string description: type: string id: type: string is_enabled: type: boolean is_package: type: boolean is_subscribed: type: boolean name: type: string old_id: type: string package_items: description: 组合包信息 items: $ref: '#/definitions/responses.PackageItemResponse' type: array price: type: number seo_description: type: string seo_keywords: type: string seo_title: description: SEO信息 type: string updated_at: type: string type: object responses.ProductInfoWithDocumentResponse: properties: category: allOf: - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' description: 关联信息 category_id: type: string code: type: string content: type: string created_at: type: string description: type: string documentation: $ref: '#/definitions/responses.DocumentationResponse' id: type: string is_enabled: type: boolean is_package: type: boolean is_subscribed: type: boolean name: type: string old_id: type: string package_items: description: 组合包信息 items: $ref: '#/definitions/responses.PackageItemResponse' type: array price: type: number seo_description: type: string seo_keywords: type: string seo_title: description: SEO信息 type: string updated_at: type: string type: object responses.ProductListResponse: properties: items: items: $ref: '#/definitions/responses.ProductInfoResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.ProductSimpleResponse: properties: category: $ref: '#/definitions/responses.CategorySimpleResponse' code: type: string description: type: string id: type: string is_package: type: boolean is_subscribed: type: boolean name: type: string old_id: type: string price: type: number type: object responses.ProductStatsResponse: properties: enabled_products: type: integer package_products: type: integer total_products: type: integer visible_products: type: integer type: object responses.RechargeConfigResponse: properties: alipay_recharge_bonus: items: $ref: '#/definitions/responses.AlipayRechargeBonusRuleResponse' type: array max_amount: description: 最高充值金额 type: string min_amount: description: 最低充值金额 type: string type: object responses.RechargeRecordListResponse: properties: items: items: $ref: '#/definitions/responses.RechargeRecordResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.RechargeRecordResponse: properties: alipay_order_id: type: string amount: type: number company_name: type: string created_at: type: string id: type: string notes: type: string operator_id: type: string recharge_type: type: string status: type: string transfer_order_id: type: string updated_at: type: string user: $ref: '#/definitions/tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse' user_id: type: string type: object responses.RegisterUserResponse: description: 用户注册成功响应 properties: id: example: 123e4567-e89b-12d3-a456-426614174000 type: string phone: example: "13800138000" type: string type: object responses.RequestParamResponse: properties: description: type: string example: type: string field: type: string name: type: string required: type: boolean type: type: string validation: type: string type: object responses.ResponseFieldResponse: properties: description: type: string example: type: string name: type: string path: type: string required: type: boolean type: type: string type: object responses.SubscriptionInfoResponse: properties: api_used: type: integer created_at: type: string id: type: string price: type: number product: $ref: '#/definitions/responses.ProductSimpleResponse' product_id: type: string updated_at: type: string user: allOf: - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.UserSimpleResponse' description: 关联信息 user_id: type: string type: object responses.SubscriptionListResponse: properties: items: items: $ref: '#/definitions/responses.SubscriptionInfoResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.SubscriptionStatsResponse: properties: total_revenue: type: number total_subscriptions: type: integer type: object responses.TagInfoResponse: properties: color: type: string created_at: type: string id: type: string name: type: string type: object responses.UserDetailResponse: properties: created_at: type: string enterprise_info: allOf: - $ref: '#/definitions/responses.EnterpriseInfoItem' description: 企业信息 id: type: string is_active: type: boolean is_certified: type: boolean last_login_at: type: string login_count: type: integer phone: type: string updated_at: type: string user_type: type: string username: type: string wallet_balance: description: 钱包信息 type: string type: object responses.UserListItem: properties: created_at: type: string enterprise_info: allOf: - $ref: '#/definitions/responses.EnterpriseInfoItem' description: 企业信息 id: type: string is_active: type: boolean is_certified: type: boolean last_login_at: type: string login_count: type: integer phone: type: string updated_at: type: string user_type: type: string username: type: string wallet_balance: description: 钱包信息 type: string type: object responses.UserListResponse: properties: items: items: $ref: '#/definitions/responses.UserListItem' type: array page: type: integer size: type: integer total: type: integer type: object responses.UserProfileResponse: description: 用户基本信息 properties: created_at: example: "2024-01-01T00:00:00Z" type: string enterprise_info: $ref: '#/definitions/responses.EnterpriseInfoResponse' id: example: 123e4567-e89b-12d3-a456-426614174000 type: string is_active: example: true type: boolean is_certified: example: false type: boolean last_login_at: example: "2024-01-01T00:00:00Z" type: string login_count: example: 10 type: integer permissions: example: - '[''user:read''' - '''user:write'']' items: type: string type: array phone: example: "13800138000" type: string updated_at: example: "2024-01-01T00:00:00Z" type: string user_type: example: user type: string username: example: admin type: string type: object responses.UserStatsResponse: properties: active_users: type: integer certified_users: type: integer total_users: type: integer type: object responses.WalletResponse: properties: balance: type: number balance_status: description: normal, low, arrears type: string created_at: type: string id: type: string is_active: type: boolean is_arrears: description: 是否欠费 type: boolean is_low_balance: description: 是否余额较低 type: boolean updated_at: type: string user_id: type: string type: object responses.WalletTransactionListResponse: properties: items: items: $ref: '#/definitions/responses.WalletTransactionResponse' type: array page: type: integer size: type: integer total: type: integer type: object responses.WalletTransactionResponse: properties: amount: type: number api_call_id: type: string company_name: type: string created_at: type: string id: type: string product_id: type: string product_name: type: string transaction_id: type: string updated_at: type: string user: $ref: '#/definitions/tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse' user_id: type: string type: object tyapi-server_internal_application_article_dto_responses.CategoryInfoResponse: properties: created_at: type: string description: type: string id: type: string is_active: type: boolean name: type: string sort_order: type: integer type: object tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse: properties: company_name: type: string id: type: string phone: type: string type: object tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse: properties: code: type: string created_at: type: string description: type: string id: type: string is_enabled: type: boolean is_visible: type: boolean name: type: string sort: type: integer updated_at: type: string type: object tyapi-server_internal_application_product_dto_responses.UserSimpleResponse: properties: company_name: type: string id: type: string phone: type: string type: object value_objects.ContractInfo: properties: contract_file_id: description: 合同基本信息 type: string contract_sign_url: description: 合同签署链接 type: string contract_title: description: 合同元数据 type: string contract_url: description: 合同文件访问链接 type: string contract_version: description: 合同版本 type: string esign_flow_id: description: e签宝签署流程ID type: string expires_at: description: 签署链接过期时间 type: string generated_at: description: 时间信息 type: string metadata: additionalProperties: true description: 附加信息 type: object sign_flow_created_at: description: 签署流程创建时间 type: string sign_progress: description: 签署进度 type: integer signed_at: description: 签署完成时间 type: string signer_account: description: 签署相关信息 type: string signer_name: description: 签署人姓名 type: string status: description: 状态信息 type: string template_id: description: 模板ID type: string transactor_id_card_num: description: 经办人身份证号 type: string transactor_name: description: 经办人姓名 type: string transactor_phone: description: 经办人手机号 type: string type: object value_objects.EnterpriseInfo: properties: company_name: description: 企业基本信息 type: string enterprise_address: description: 企业地址（新增） type: string legal_person_id: description: 法定代表人身份证号 type: string legal_person_name: description: 法定代表人信息 type: string legal_person_phone: description: 法定代表人手机号 type: string registered_address: description: 企业详细信息 type: string unified_social_code: description: 统一社会信用代码 type: string type: object value_objects.InvoiceInfo: properties: bank_account: description: 基本开户账号 type: string bank_name: description: 基本开户银行 type: string company_address: description: 企业注册地址 type: string company_name: description: 公司名称 type: string company_phone: description: 企业注册电话 type: string receiving_email: description: 发票接收邮箱 type: string taxpayer_id: description: 纳税人识别号 type: string type: object value_objects.InvoiceType: enum: - general - special type: string x-enum-comments: InvoiceTypeGeneral: 增值税普通发票 (普票) InvoiceTypeSpecial: 增值税专用发票 (专票) x-enum-descriptions: - 增值税普通发票 (普票) - 增值税专用发票 (专票) x-enum-varnames: - InvoiceTypeGeneral - InvoiceTypeSpecial host: localhost:8080 info: contact: email: support@example.com name: API Support url: https://github.com/your-org/tyapi-server-gin description: |- 基于DDD和Clean Architecture的企业级后端API服务 采用Gin框架构建，支持用户管理、JWT认证、事件驱动等功能 license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html title: TYAPI Server API version: "1.0" paths: /api/v1/:api_name: post: consumes: - application/json description: 统一API调用入口，参数加密传输 parameters: - description: API调用请求 in: body name: request required: true schema: $ref: '#/definitions/commands.ApiCallCommand' produces: - application/json responses: "200": description: 调用成功 schema: $ref: '#/definitions/dto.ApiCallResponse' "400": description: 请求参数错误 schema: $ref: '#/definitions/dto.ApiCallResponse' "401": description: 未授权 schema: $ref: '#/definitions/dto.ApiCallResponse' "429": description: 请求过于频繁 schema: $ref: '#/definitions/dto.ApiCallResponse' "500": description: 服务器内部错误 schema: $ref: '#/definitions/dto.ApiCallResponse' summary: API调用 tags: - API调用 /api/v1/admin/api-calls: get: consumes: - application/json description: 管理员获取API调用记录，支持筛选和分页 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 用户ID in: query name: user_id type: string - description: 交易ID in: query name: transaction_id type: string - description: 产品名称 in: query name: product_name type: string - description: 状态 in: query name: status type: string - description: 开始时间 format: date-time in: query name: start_time type: string - description: 结束时间 format: date-time in: query name: end_time type: string - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取API调用记录成功 schema: $ref: '#/definitions/dto.ApiCallListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取管理端API调用记录 tags: - API管理 /api/v1/admin/invoices/{application_id}/approve: post: consumes: - multipart/form-data description: 管理员通过发票申请并上传发票文件 parameters: - description: 申请ID in: path name: application_id required: true type: string - description: 发票文件 in: formData name: file required: true type: file - description: 管理员备注 in: formData name: admin_notes type: string produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/interfaces.APIResponse' "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 通过发票申请 tags: - 管理员-发票管理 /api/v1/admin/invoices/{application_id}/download: get: description: 管理员下载指定发票的文件 parameters: - description: 申请ID in: path name: application_id required: true type: string produces: - application/octet-stream responses: "200": description: OK schema: type: file "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 管理员下载发票文件 tags: - 管理员-发票管理 /api/v1/admin/invoices/{application_id}/reject: post: consumes: - application/json description: 管理员拒绝发票申请 parameters: - description: 申请ID in: path name: application_id required: true type: string - description: 拒绝申请请求 in: body name: request required: true schema: $ref: '#/definitions/finance.RejectInvoiceRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/interfaces.APIResponse' "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 拒绝发票申请 tags: - 管理员-发票管理 /api/v1/admin/invoices/pending: get: description: 管理员获取发票申请列表，支持状态和时间范围筛选 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 状态筛选：pending/completed/rejected in: query name: status type: string - description: '开始时间 (格式: 2006-01-02 15:04:05)' in: query name: start_time type: string - description: '结束时间 (格式: 2006-01-02 15:04:05)' in: query name: end_time type: string produces: - application/json responses: "200": description: OK schema: allOf: - $ref: '#/definitions/interfaces.APIResponse' - properties: data: $ref: '#/definitions/dto.PendingApplicationsResponse' type: object "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 获取发票申请列表 tags: - 管理员-发票管理 /api/v1/admin/product-categories: get: consumes: - application/json description: 管理员获取产品分类列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer produces: - application/json responses: "200": description: 获取分类列表成功 schema: $ref: '#/definitions/responses.CategoryListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取分类列表 tags: - 分类管理 post: consumes: - application/json description: 管理员创建新产品分类 parameters: - description: 创建分类请求 in: body name: request required: true schema: $ref: '#/definitions/commands.CreateCategoryCommand' produces: - application/json responses: "201": description: 分类创建成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建分类 tags: - 分类管理 /api/v1/admin/product-categories/{id}: delete: consumes: - application/json description: 管理员删除产品分类 parameters: - description: 分类ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 分类删除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 分类不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除分类 tags: - 分类管理 get: consumes: - application/json description: 管理员获取分类详细信息 parameters: - description: 分类ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取分类详情成功 schema: $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 分类不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取分类详情 tags: - 分类管理 put: consumes: - application/json description: 管理员更新产品分类信息 parameters: - description: 分类ID in: path name: id required: true type: string - description: 更新分类请求 in: body name: request required: true schema: $ref: '#/definitions/commands.UpdateCategoryCommand' produces: - application/json responses: "200": description: 分类更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 分类不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新分类 tags: - 分类管理 /api/v1/admin/products: get: consumes: - application/json description: 管理员获取产品列表，支持筛选和分页，包含所有产品（包括隐藏的） parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 搜索关键词 in: query name: keyword type: string - description: 分类ID in: query name: category_id type: string - description: 是否启用 in: query name: is_enabled type: boolean - description: 是否可见 in: query name: is_visible type: boolean - description: 是否组合包 in: query name: is_package type: boolean - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取产品列表成功 schema: $ref: '#/definitions/responses.ProductAdminListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取产品列表 tags: - 产品管理 post: consumes: - application/json description: 管理员创建新产品 parameters: - description: 创建产品请求 in: body name: request required: true schema: $ref: '#/definitions/commands.CreateProductCommand' produces: - application/json responses: "201": description: 产品创建成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建产品 tags: - 产品管理 /api/v1/admin/products/{id}: delete: consumes: - application/json description: 管理员删除产品 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 产品删除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除产品 tags: - 产品管理 get: consumes: - application/json description: 管理员获取产品详细信息 parameters: - description: 产品ID in: path name: id required: true type: string - description: 是否包含文档信息 in: query name: with_document type: boolean produces: - application/json responses: "200": description: 获取产品详情成功 schema: $ref: '#/definitions/responses.ProductAdminInfoResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取产品详情 tags: - 产品管理 put: consumes: - application/json description: 管理员更新产品信息 parameters: - description: 产品ID in: path name: id required: true type: string - description: 更新产品请求 in: body name: request required: true schema: $ref: '#/definitions/commands.UpdateProductCommand' produces: - application/json responses: "200": description: 产品更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新产品 tags: - 产品管理 /api/v1/admin/products/{id}/api-config: delete: consumes: - application/json description: 管理员删除产品的API配置 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: API配置删除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品或API配置不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除产品API配置 tags: - 产品管理 get: consumes: - application/json description: 管理员获取产品的API配置信息，如果不存在则返回空配置 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取API配置成功 schema: $ref: '#/definitions/responses.ProductApiConfigResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取产品API配置 tags: - 产品管理 post: consumes: - application/json description: 管理员为产品创建API配置 parameters: - description: 产品ID in: path name: id required: true type: string - description: API配置信息 in: body name: request required: true schema: $ref: '#/definitions/responses.ProductApiConfigResponse' produces: - application/json responses: "201": description: API配置创建成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "409": description: API配置已存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建产品API配置 tags: - 产品管理 put: consumes: - application/json description: 管理员更新产品的API配置 parameters: - description: 产品ID in: path name: id required: true type: string - description: API配置信息 in: body name: request required: true schema: $ref: '#/definitions/responses.ProductApiConfigResponse' produces: - application/json responses: "200": description: API配置更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品或配置不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新产品API配置 tags: - 产品管理 /api/v1/admin/products/{id}/documentation: delete: consumes: - application/json description: 管理员删除产品的文档 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 文档删除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品或文档不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除产品文档 tags: - 产品管理 get: consumes: - application/json description: 管理员获取产品的文档信息 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取文档成功 schema: $ref: '#/definitions/responses.DocumentationResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品或文档不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取产品文档 tags: - 产品管理 post: consumes: - application/json description: 管理员创建或更新产品的文档信息，如果文档不存在则创建，存在则更新 parameters: - description: 产品ID in: path name: id required: true type: string - description: 文档信息 in: body name: request required: true schema: $ref: '#/definitions/commands.CreateDocumentationCommand' produces: - application/json responses: "200": description: 文档操作成功 schema: $ref: '#/definitions/responses.DocumentationResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建或更新产品文档 tags: - 产品管理 /api/v1/admin/products/{id}/package-items: post: consumes: - application/json description: 管理员向组合包添加子产品 parameters: - description: 组合包ID in: path name: id required: true type: string - description: 添加子产品命令 in: body name: command required: true schema: $ref: '#/definitions/commands.AddPackageItemCommand' produces: - application/json responses: "200": description: 添加成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 添加组合包子产品 tags: - 产品管理 /api/v1/admin/products/{id}/package-items/{item_id}: delete: consumes: - application/json description: 管理员从组合包移除子产品 parameters: - description: 组合包ID in: path name: id required: true type: string - description: 子产品项目ID in: path name: item_id required: true type: string produces: - application/json responses: "200": description: 移除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 移除组合包子产品 tags: - 产品管理 put: consumes: - application/json description: 管理员更新组合包子产品信息 parameters: - description: 组合包ID in: path name: id required: true type: string - description: 子产品项目ID in: path name: item_id required: true type: string - description: 更新子产品命令 in: body name: command required: true schema: $ref: '#/definitions/commands.UpdatePackageItemCommand' produces: - application/json responses: "200": description: 更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新组合包子产品 tags: - 产品管理 /api/v1/admin/products/{id}/package-items/batch: put: consumes: - application/json description: 管理员批量更新组合包子产品配置 parameters: - description: 组合包ID in: path name: id required: true type: string - description: 批量更新命令 in: body name: command required: true schema: $ref: '#/definitions/commands.UpdatePackageItemsCommand' produces: - application/json responses: "200": description: 更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 批量更新组合包子产品 tags: - 产品管理 /api/v1/admin/products/{id}/package-items/reorder: put: consumes: - application/json description: 管理员重新排序组合包子产品 parameters: - description: 组合包ID in: path name: id required: true type: string - description: 重新排序命令 in: body name: command required: true schema: $ref: '#/definitions/commands.ReorderPackageItemsCommand' produces: - application/json responses: "200": description: 排序成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 重新排序组合包子产品 tags: - 产品管理 /api/v1/admin/products/available: get: consumes: - application/json description: 管理员获取可选作组合包子产品的产品列表 parameters: - description: 排除的组合包ID in: query name: exclude_package_id type: string - description: 搜索关键词 in: query name: keyword type: string - description: 分类ID in: query name: category_id type: string - default: 1 description: 页码 in: query name: page type: integer - default: 20 description: 每页数量 in: query name: page_size type: integer produces: - application/json responses: "200": description: 获取可选产品列表成功 schema: $ref: '#/definitions/responses.ProductListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取可选子产品列表 tags: - 产品管理 /api/v1/admin/recharge-records: get: consumes: - application/json description: 管理员获取充值记录，支持筛选和分页 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 用户ID in: query name: user_id type: string - description: 充值类型 enum: - alipay - transfer - gift in: query name: recharge_type type: string - description: 状态 enum: - pending - success - failed in: query name: status type: string - description: 最小金额 in: query name: min_amount type: string - description: 最大金额 in: query name: max_amount type: string - description: 开始时间 format: date-time in: query name: start_time type: string - description: 结束时间 format: date-time in: query name: end_time type: string - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取充值记录成功 schema: $ref: '#/definitions/responses.RechargeRecordListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取管理端充值记录 tags: - 财务管理 /api/v1/admin/subscriptions: get: consumes: - application/json description: 管理员获取订阅列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 搜索关键词 in: query name: keyword type: string - description: 企业名称 in: query name: company_name type: string - description: 产品名称 in: query name: product_name type: string - description: 订阅开始时间 format: date-time in: query name: start_time type: string - description: 订阅结束时间 format: date-time in: query name: end_time type: string - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取订阅列表成功 schema: $ref: '#/definitions/responses.SubscriptionListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取订阅列表 tags: - 订阅管理 /api/v1/admin/subscriptions/{id}/price: put: consumes: - application/json description: 管理员修改用户订阅价格 parameters: - description: 订阅ID in: path name: id required: true type: string - description: 更新订阅价格请求 in: body name: request required: true schema: $ref: '#/definitions/commands.UpdateSubscriptionPriceCommand' produces: - application/json responses: "200": description: 订阅价格更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 订阅不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新订阅价格 tags: - 订阅管理 /api/v1/admin/subscriptions/batch-update-prices: post: consumes: - application/json description: 管理员一键调整用户所有订阅的价格 parameters: - description: 批量改价请求 in: body name: request required: true schema: $ref: '#/definitions/commands.BatchUpdateSubscriptionPricesCommand' produces: - application/json responses: "200": description: 一键改价成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 一键改价 tags: - 订阅管理 /api/v1/admin/subscriptions/stats: get: consumes: - application/json description: 管理员获取订阅统计信息 produces: - application/json responses: "200": description: 获取订阅统计成功 schema: $ref: '#/definitions/responses.SubscriptionStatsResponse' "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取订阅统计 tags: - 订阅管理 /api/v1/admin/wallet-transactions: get: consumes: - application/json description: 管理员获取消费记录，支持筛选和分页 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 用户ID in: query name: user_id type: string - description: 交易ID in: query name: transaction_id type: string - description: 产品名称 in: query name: product_name type: string - description: 最小金额 in: query name: min_amount type: string - description: 最大金额 in: query name: max_amount type: string - description: 开始时间 format: date-time in: query name: start_time type: string - description: 结束时间 format: date-time in: query name: end_time type: string - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取消费记录成功 schema: $ref: '#/definitions/responses.WalletTransactionListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取管理端消费记录 tags: - 财务管理 /api/v1/articles: get: consumes: - application/json description: 分页获取文章列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 文章状态 in: query name: status type: string - description: 分类ID in: query name: category_id type: string - description: 作者ID in: query name: author_id type: string - description: 是否推荐 in: query name: is_featured type: boolean - description: 排序字段 in: query name: order_by type: string - description: 排序方向 in: query name: order_dir type: string produces: - application/json responses: "200": description: 获取文章列表成功 schema: $ref: '#/definitions/responses.ArticleListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取文章列表 tags: - 文章管理 post: consumes: - application/json description: 创建新的文章 parameters: - description: 创建文章请求 in: body name: request required: true schema: $ref: '#/definitions/commands.CreateArticleCommand' produces: - application/json responses: "201": description: 文章创建成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建文章 tags: - 文章管理 /api/v1/articles/{id}: delete: consumes: - application/json description: 删除指定文章 parameters: - description: 文章ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 文章删除成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除文章 tags: - 文章管理 get: consumes: - application/json description: 根据ID获取文章详情 parameters: - description: 文章ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取文章详情成功 schema: $ref: '#/definitions/responses.ArticleInfoResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取文章详情 tags: - 文章管理 put: consumes: - application/json description: 更新文章信息 parameters: - description: 文章ID in: path name: id required: true type: string - description: 更新文章请求 in: body name: request required: true schema: $ref: '#/definitions/commands.UpdateArticleCommand' produces: - application/json responses: "200": description: 文章更新成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 更新文章 tags: - 文章管理 /api/v1/articles/{id}/archive: post: consumes: - application/json description: 将已发布文章归档 parameters: - description: 文章ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 文章归档成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 归档文章 tags: - 文章管理 /api/v1/articles/{id}/featured: put: consumes: - application/json description: 设置文章的推荐状态 parameters: - description: 文章ID in: path name: id required: true type: string - description: 设置推荐状态请求 in: body name: request required: true schema: $ref: '#/definitions/commands.SetFeaturedCommand' produces: - application/json responses: "200": description: 设置推荐状态成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 设置推荐状态 tags: - 文章管理 /api/v1/articles/{id}/publish: post: consumes: - application/json description: 将草稿文章发布 parameters: - description: 文章ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 文章发布成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 文章不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 发布文章 tags: - 文章管理 /api/v1/articles/search: get: consumes: - application/json description: 根据关键词搜索文章 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 搜索关键词 in: query name: keyword required: true type: string - description: 分类ID in: query name: category_id type: string - description: 作者ID in: query name: author_id type: string - description: 文章状态 in: query name: status type: string - description: 排序字段 in: query name: order_by type: string - description: 排序方向 in: query name: order_dir type: string produces: - application/json responses: "200": description: 搜索文章成功 schema: $ref: '#/definitions/responses.ArticleListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 搜索文章 tags: - 文章管理 /api/v1/articles/stats: get: consumes: - application/json description: 获取文章相关统计数据 produces: - application/json responses: "200": description: 获取统计成功 schema: $ref: '#/definitions/responses.ArticleStatsResponse' "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取文章统计 tags: - 文章管理 /api/v1/categories: get: consumes: - application/json description: 获取产品分类列表，支持筛选 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 是否启用 in: query name: is_enabled type: boolean - description: 是否可见 in: query name: is_visible type: boolean produces: - application/json responses: "200": description: 获取分类列表成功 schema: $ref: '#/definitions/responses.CategoryListResponse' "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取分类列表 tags: - 数据大厅 /api/v1/categories/{id}: get: consumes: - application/json description: 根据分类ID获取分类详细信息 parameters: - description: 分类ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取分类详情成功 schema: $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "404": description: 分类不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取分类详情 tags: - 数据大厅 /api/v1/certifications: get: consumes: - application/json description: 管理员获取认证申请列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string - description: 认证状态 in: query name: status type: string - description: 用户ID in: query name: user_id type: string - description: 公司名称 in: query name: company_name type: string - description: 法人姓名 in: query name: legal_person_name type: string - description: 搜索关键词 in: query name: search_keyword type: string produces: - application/json responses: "200": description: 获取认证列表成功 schema: $ref: '#/definitions/responses.CertificationListResponse' "401": description: 未认证 schema: additionalProperties: true type: object "403": description: 权限不足 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取认证列表 tags: - 认证管理 /api/v1/certifications/apply-contract: post: consumes: - application/json description: 申请企业认证合同签署 parameters: - description: 申请合同请求 in: body name: request required: true schema: $ref: '#/definitions/commands.ApplyContractCommand' produces: - application/json responses: "200": description: 合同申请成功 schema: $ref: '#/definitions/responses.ContractSignUrlResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 认证记录不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 申请合同签署 tags: - 认证管理 /api/v1/certifications/confirm-auth: post: consumes: - application/json description: 前端轮询确认企业认证是否完成 parameters: - description: 确认状态请求 in: body name: request required: true schema: $ref: '#/definitions/queries.ConfirmAuthCommand' produces: - application/json responses: "200": description: 状态确认成功 schema: $ref: '#/definitions/responses.ConfirmAuthResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 认证记录不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 前端确认认证状态 tags: - 认证管理 /api/v1/certifications/confirm-sign: post: consumes: - application/json description: 前端轮询确认合同签署是否完成 parameters: - description: 确认状态请求 in: body name: request required: true schema: $ref: '#/definitions/queries.ConfirmSignCommand' produces: - application/json responses: "200": description: 状态确认成功 schema: $ref: '#/definitions/responses.ConfirmSignResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 认证记录不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 前端确认签署状态 tags: - 认证管理 /api/v1/certifications/details: get: consumes: - application/json description: 根据认证ID获取认证详情 produces: - application/json responses: "200": description: 获取认证详情成功 schema: $ref: '#/definitions/responses.CertificationResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 认证记录不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取认证详情 tags: - 认证管理 /api/v1/certifications/enterprise-info: post: consumes: - application/json description: 提交企业认证所需的企业信息 parameters: - description: 提交企业信息请求 in: body name: request required: true schema: $ref: '#/definitions/commands.SubmitEnterpriseInfoCommand' produces: - application/json responses: "200": description: 企业信息提交成功 schema: $ref: '#/definitions/responses.CertificationResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 认证记录不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 提交企业信息 tags: - 认证管理 /api/v1/certifications/esign/callback: post: consumes: - application/json description: 处理e签宝的异步回调通知 produces: - text/plain responses: "200": description: success schema: type: string "400": description: fail schema: type: string summary: 处理e签宝回调 tags: - 认证管理 /api/v1/debug/event-system: post: consumes: - application/json description: 调试事件系统，用于测试事件触发和处理 produces: - application/json responses: "200": description: 调试成功 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 调试事件系统 tags: - 系统调试 /api/v1/decrypt: post: consumes: - application/json description: 使用密钥解密加密的数据 parameters: - description: 解密请求 in: body name: request required: true schema: $ref: '#/definitions/commands.DecryptCommand' produces: - application/json responses: "200": description: 解密成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未授权 schema: additionalProperties: true type: object "500": description: 解密失败 schema: additionalProperties: true type: object security: - Bearer: [] summary: 解密参数 tags: - API调试 /api/v1/encrypt: post: consumes: - application/json description: 用于前端调试时加密API调用参数 parameters: - description: 加密请求 in: body name: request required: true schema: $ref: '#/definitions/commands.EncryptCommand' produces: - application/json responses: "200": description: 加密成功 schema: $ref: '#/definitions/dto.EncryptResponse' "400": description: 请求参数错误 schema: $ref: '#/definitions/dto.EncryptResponse' "401": description: 未授权 schema: $ref: '#/definitions/dto.EncryptResponse' summary: 加密参数 tags: - API调试 /api/v1/finance/alipay/callback: post: consumes: - application/x-www-form-urlencoded description: 处理支付宝异步支付通知 produces: - text/plain responses: "200": description: success schema: type: string "400": description: fail schema: type: string summary: 支付宝支付回调 tags: - 支付管理 /api/v1/finance/alipay/return: get: consumes: - application/x-www-form-urlencoded description: 处理支付宝同步支付通知，跳转到前端成功页面 produces: - text/html responses: "200": description: 支付成功页面 schema: type: string "400": description: 支付失败页面 schema: type: string summary: 支付宝同步回调 tags: - 支付管理 /api/v1/finance/wallet: get: consumes: - application/json description: 获取当前用户的钱包详细信息 produces: - application/json responses: "200": description: 获取钱包信息成功 schema: $ref: '#/definitions/responses.WalletResponse' "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 钱包不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取钱包信息 tags: - 钱包管理 /api/v1/finance/wallet/alipay-order-status: get: consumes: - application/json description: 获取支付宝订单的当前状态，用于轮询查询 parameters: - description: 商户订单号 in: query name: out_trade_no required: true type: string produces: - application/json responses: "200": description: 获取订单状态成功 schema: $ref: '#/definitions/responses.AlipayOrderStatusResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 订单不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取支付宝订单状态 tags: - 钱包管理 /api/v1/finance/wallet/alipay-recharge: post: consumes: - application/json description: 创建支付宝充值订单并返回支付链接 parameters: - description: 充值请求 in: body name: request required: true schema: $ref: '#/definitions/commands.CreateAlipayRechargeCommand' produces: - application/json responses: "200": description: 创建充值订单成功 schema: $ref: '#/definitions/responses.AlipayRechargeOrderResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 创建支付宝充值订单 tags: - 钱包管理 /api/v1/finance/wallet/recharge-config: get: consumes: - application/json description: 获取当前环境的充值配置信息（最低充值金额、最高充值金额等） produces: - application/json responses: "200": description: 获取充值配置成功 schema: $ref: '#/definitions/responses.RechargeConfigResponse' "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取充值配置 tags: - 钱包管理 /api/v1/finance/wallet/transactions: get: consumes: - application/json description: 获取当前用户的钱包交易记录列表，支持分页和筛选 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: '开始时间 (格式: 2006-01-02 15:04:05)' in: query name: start_time type: string - description: '结束时间 (格式: 2006-01-02 15:04:05)' in: query name: end_time type: string - description: 交易ID in: query name: transaction_id type: string - description: 产品名称 in: query name: product_name type: string - description: 最小金额 in: query name: min_amount type: string - description: 最大金额 in: query name: max_amount type: string produces: - application/json responses: "200": description: 获取成功 schema: $ref: '#/definitions/responses.WalletTransactionListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取用户钱包交易记录 tags: - 钱包管理 /api/v1/form-config/{api_code}: get: consumes: - application/json description: 获取指定API的表单配置，用于前端动态生成表单 parameters: - description: API代码 in: path name: api_code required: true type: string produces: - application/json responses: "200": description: 获取成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未授权 schema: additionalProperties: true type: object "404": description: API接口不存在 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取表单配置 tags: - API调试 /api/v1/invoices/{application_id}/download: get: description: 下载指定发票的文件 parameters: - description: 申请ID in: path name: application_id required: true type: string produces: - application/octet-stream responses: "200": description: OK schema: type: file "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 下载发票文件 tags: - 发票管理 /api/v1/invoices/apply: post: consumes: - application/json description: 用户申请开票 parameters: - description: 申请开票请求 in: body name: request required: true schema: $ref: '#/definitions/finance.ApplyInvoiceRequest' produces: - application/json responses: "200": description: OK schema: allOf: - $ref: '#/definitions/interfaces.APIResponse' - properties: data: $ref: '#/definitions/dto.InvoiceApplicationResponse' type: object "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 申请开票 tags: - 发票管理 /api/v1/invoices/available-amount: get: description: 获取用户当前可开票的金额 produces: - application/json responses: "200": description: OK schema: allOf: - $ref: '#/definitions/interfaces.APIResponse' - properties: data: $ref: '#/definitions/dto.AvailableAmountResponse' type: object "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 获取可开票金额 tags: - 发票管理 /api/v1/invoices/info: get: description: 获取用户的发票信息 produces: - application/json responses: "200": description: OK schema: allOf: - $ref: '#/definitions/interfaces.APIResponse' - properties: data: $ref: '#/definitions/dto.InvoiceInfoResponse' type: object "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 获取用户发票信息 tags: - 发票管理 put: consumes: - application/json description: 更新用户的发票信息 parameters: - description: 更新发票信息请求 in: body name: request required: true schema: $ref: '#/definitions/finance.UpdateInvoiceInfoRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/interfaces.APIResponse' "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 更新用户发票信息 tags: - 发票管理 /api/v1/invoices/records: get: description: 获取用户的开票记录列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 状态筛选 in: query name: status type: string produces: - application/json responses: "200": description: OK schema: allOf: - $ref: '#/definitions/interfaces.APIResponse' - properties: data: $ref: '#/definitions/dto.InvoiceRecordsResponse' type: object "400": description: Bad Request schema: $ref: '#/definitions/interfaces.APIResponse' "500": description: Internal Server Error schema: $ref: '#/definitions/interfaces.APIResponse' summary: 获取用户开票记录 tags: - 发票管理 /api/v1/my/api-calls: get: consumes: - application/json description: 获取当前用户的API调用记录列表，支持分页和筛选 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: '开始时间 (格式: 2006-01-02 15:04:05)' in: query name: start_time type: string - description: '结束时间 (格式: 2006-01-02 15:04:05)' in: query name: end_time type: string - description: 交易ID in: query name: transaction_id type: string - description: 产品名称 in: query name: product_name type: string - description: 状态 (pending/success/failed) in: query name: status type: string produces: - application/json responses: "200": description: 获取成功 schema: $ref: '#/definitions/dto.ApiCallListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取用户API调用记录 tags: - API管理 /api/v1/my/subscriptions: get: consumes: - application/json description: 获取当前用户的订阅列表 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 搜索关键词 in: query name: keyword type: string - description: 产品名称 in: query name: product_name type: string - description: 订阅开始时间 format: date-time in: query name: start_time type: string - description: 订阅结束时间 format: date-time in: query name: end_time type: string - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取订阅列表成功 schema: $ref: '#/definitions/responses.SubscriptionListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取我的订阅列表 tags: - 我的订阅 /api/v1/my/subscriptions/{id}: get: consumes: - application/json description: 获取指定订阅的详细信息 parameters: - description: 订阅ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取订阅详情成功 schema: $ref: '#/definitions/responses.SubscriptionInfoResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 订阅不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取我的订阅详情 tags: - 我的订阅 /api/v1/my/subscriptions/{id}/usage: get: consumes: - application/json description: 获取指定订阅的使用情况统计 parameters: - description: 订阅ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取使用情况成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 订阅不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取我的订阅使用情况 tags: - 我的订阅 /api/v1/my/subscriptions/stats: get: consumes: - application/json description: 获取当前用户的订阅统计信息 produces: - application/json responses: "200": description: 获取订阅统计成功 schema: $ref: '#/definitions/responses.SubscriptionStatsResponse' "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取我的订阅统计 tags: - 我的订阅 /api/v1/my/whitelist/{ip}: delete: consumes: - application/json description: 从当前用户的白名单中删除指定IP地址 parameters: - description: IP地址 in: path name: ip required: true type: string produces: - application/json responses: "200": description: 删除白名单IP成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 删除白名单IP tags: - API管理 /api/v1/products: get: consumes: - application/json description: 分页获取可用的产品列表，支持筛选，默认只返回可见的产品 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 搜索关键词 in: query name: keyword type: string - description: 分类ID in: query name: category_id type: string - description: 是否启用 in: query name: is_enabled type: boolean - description: 是否可见 in: query name: is_visible type: boolean - description: 是否组合包 in: query name: is_package type: boolean - description: 是否已订阅（需要认证） in: query name: is_subscribed type: boolean - description: 排序字段 in: query name: sort_by type: string - description: 排序方向 enum: - asc - desc in: query name: sort_order type: string produces: - application/json responses: "200": description: 获取产品列表成功 schema: $ref: '#/definitions/responses.ProductListResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取产品列表 tags: - 数据大厅 /api/v1/products/{id}: get: consumes: - application/json description: 获取产品详细信息，用户端只能查看可见的产品 parameters: - description: 产品ID in: path name: id required: true type: string - description: 是否包含文档信息 in: query name: with_document type: boolean produces: - application/json responses: "200": description: 获取产品详情成功 schema: $ref: '#/definitions/responses.ProductInfoWithDocumentResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "404": description: 产品不存在或不可见 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取产品详情 tags: - 数据大厅 /api/v1/products/{id}/api-config: get: consumes: - application/json description: 根据产品ID获取API配置信息 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取成功 schema: $ref: '#/definitions/responses.ProductApiConfigResponse' "400": description: 请求参数错误 schema: $ref: '#/definitions/interfaces.APIResponse' "404": description: 配置不存在 schema: $ref: '#/definitions/interfaces.APIResponse' summary: 获取产品API配置 tags: - 产品API配置 /api/v1/products/{id}/documentation: get: consumes: - application/json description: 获取指定产品的文档信息 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 获取产品文档成功 schema: $ref: '#/definitions/responses.DocumentationResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取产品文档 tags: - 数据大厅 /api/v1/products/{id}/subscribe: post: consumes: - application/json description: 用户订阅指定产品 parameters: - description: 产品ID in: path name: id required: true type: string produces: - application/json responses: "200": description: 订阅成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 产品不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 订阅产品 tags: - 数据大厅 /api/v1/products/code/{product_code}/api-config: get: consumes: - application/json description: 根据产品代码获取API配置信息 parameters: - description: 产品代码 in: path name: product_code required: true type: string produces: - application/json responses: "200": description: 获取成功 schema: $ref: '#/definitions/responses.ProductApiConfigResponse' "400": description: 请求参数错误 schema: $ref: '#/definitions/interfaces.APIResponse' "404": description: 配置不存在 schema: $ref: '#/definitions/interfaces.APIResponse' summary: 根据产品代码获取API配置 tags: - 产品API配置 /api/v1/products/stats: get: consumes: - application/json description: 获取产品相关的统计信息 produces: - application/json responses: "200": description: 获取统计信息成功 schema: $ref: '#/definitions/responses.ProductStatsResponse' "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 获取产品统计 tags: - 数据大厅 /api/v1/users/admin/{user_id}: get: consumes: - application/json description: 管理员获取指定用户的详细信息 parameters: - description: 用户ID in: path name: user_id required: true type: string produces: - application/json responses: "200": description: 用户详情 schema: $ref: '#/definitions/responses.UserDetailResponse' "401": description: 未认证 schema: additionalProperties: true type: object "403": description: 权限不足 schema: additionalProperties: true type: object "404": description: 用户不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 管理员获取用户详情 tags: - 用户管理 /api/v1/users/admin/list: get: consumes: - application/json description: 管理员查看用户列表，支持分页和筛选 parameters: - default: 1 description: 页码 in: query name: page type: integer - default: 10 description: 每页数量 in: query name: page_size type: integer - description: 手机号筛选 in: query name: phone type: string - description: 用户类型筛选 enum: - user - admin in: query name: user_type type: string - description: 是否激活筛选 in: query name: is_active type: boolean - description: 是否已认证筛选 in: query name: is_certified type: boolean - description: 企业名称筛选 in: query name: company_name type: string - description: 开始日期 format: date in: query name: start_date type: string - description: 结束日期 format: date in: query name: end_date type: string produces: - application/json responses: "200": description: 用户列表 schema: $ref: '#/definitions/responses.UserListResponse' "401": description: 未认证 schema: additionalProperties: true type: object "403": description: 权限不足 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 管理员查看用户列表 tags: - 用户管理 /api/v1/users/admin/stats: get: consumes: - application/json description: 管理员获取用户相关的统计信息 produces: - application/json responses: "200": description: 用户统计信息 schema: $ref: '#/definitions/responses.UserStatsResponse' "401": description: 未认证 schema: additionalProperties: true type: object "403": description: 权限不足 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取用户统计信息 tags: - 用户管理 /api/v1/users/login-password: post: consumes: - application/json description: 使用手机号和密码进行用户登录，返回JWT令牌 parameters: - description: 密码登录请求 in: body name: request required: true schema: $ref: '#/definitions/commands.LoginWithPasswordCommand' produces: - application/json responses: "200": description: 登录成功 schema: $ref: '#/definitions/responses.LoginUserResponse' "400": description: 请求参数错误 schema: additionalProperties: true type: object "401": description: 用户名或密码错误 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 用户密码登录 tags: - 用户认证 /api/v1/users/login-sms: post: consumes: - application/json description: 使用手机号和短信验证码进行用户登录，返回JWT令牌 parameters: - description: 短信登录请求 in: body name: request required: true schema: $ref: '#/definitions/commands.LoginWithSMSCommand' produces: - application/json responses: "200": description: 登录成功 schema: $ref: '#/definitions/responses.LoginUserResponse' "400": description: 请求参数错误或验证码无效 schema: additionalProperties: true type: object "401": description: 认证失败 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 用户短信验证码登录 tags: - 用户认证 /api/v1/users/me: get: consumes: - application/json description: 根据JWT令牌获取当前登录用户的详细信息 produces: - application/json responses: "200": description: 用户信息 schema: $ref: '#/definitions/responses.UserProfileResponse' "401": description: 未认证 schema: additionalProperties: true type: object "404": description: 用户不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 获取当前用户信息 tags: - 用户管理 /api/v1/users/me/password: put: consumes: - application/json description: 使用旧密码、新密码确认和验证码修改当前用户的密码 parameters: - description: 修改密码请求 in: body name: request required: true schema: $ref: '#/definitions/commands.ChangePasswordCommand' produces: - application/json responses: "200": description: 密码修改成功 schema: additionalProperties: true type: object "400": description: 请求参数错误或验证码无效 schema: additionalProperties: true type: object "401": description: 未认证 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object security: - Bearer: [] summary: 修改密码 tags: - 用户管理 /api/v1/users/register: post: consumes: - application/json description: 使用手机号、密码和验证码进行用户注册，需要确认密码 parameters: - description: 用户注册请求 in: body name: request required: true schema: $ref: '#/definitions/commands.RegisterUserCommand' produces: - application/json responses: "201": description: 注册成功 schema: $ref: '#/definitions/responses.RegisterUserResponse' "400": description: 请求参数错误或验证码无效 schema: additionalProperties: true type: object "409": description: 手机号已存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 用户注册 tags: - 用户认证 /api/v1/users/reset-password: post: consumes: - application/json description: 使用手机号、验证码和新密码重置用户密码（忘记密码时使用） parameters: - description: 重置密码请求 in: body name: request required: true schema: $ref: '#/definitions/commands.ResetPasswordCommand' produces: - application/json responses: "200": description: 密码重置成功 schema: additionalProperties: true type: object "400": description: 请求参数错误或验证码无效 schema: additionalProperties: true type: object "404": description: 用户不存在 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 重置密码 tags: - 用户认证 /api/v1/users/send-code: post: consumes: - application/json description: 向指定手机号发送验证码，支持注册、登录、修改密码等场景 parameters: - description: 发送验证码请求 in: body name: request required: true schema: $ref: '#/definitions/commands.SendCodeCommand' produces: - application/json responses: "200": description: 验证码发送成功 schema: additionalProperties: true type: object "400": description: 请求参数错误 schema: additionalProperties: true type: object "429": description: 请求频率限制 schema: additionalProperties: true type: object "500": description: 服务器内部错误 schema: additionalProperties: true type: object summary: 发送短信验证码 tags: - 用户认证 securityDefinitions: Bearer: description: Type "Bearer" followed by a space and JWT token. in: header name: Authorization type: apiKey swagger: "2.0"