HTTP API 与权限参考

核对基线：main 6df20471d848；重新生成不会导出插件实现。

仅收录主题可能消费的公开 API 与 UC API，不包含控制台/Extension 管理接口。 公开前缀不代表允许任意写入；回调由网关签名，评论凭证由实际提交会话验证。UC API 使用当前用户权限。 以下标注为对照的端点不在市场版合同中，Pro 是否可用仍需核对实际发行包、授权与功能配置。

GET /apis/api.knowsphere.webjing.com/v1alpha1/access/-/check

身份：公开路由，按具体操作校验；范围：市场版合同包含。 检查用户对指定内容的访问权限 operationId：CheckAccess。

参数	位置	必填	类型
type	query	True	string
name	query	True	string

响应 default */*：AccessCheckVo。

POST /apis/api.knowsphere.webjing.com/v1alpha1/access/-/comment-session

身份：公开路由，按具体操作校验；范围：市场版合同包含。 匿名评论成功后同步当前内容的访问凭证 operationId：SyncAnonymousCommentAccess。

请求 */*：AnonymousCommentAccessRequest。

GET /apis/api.knowsphere.webjing.com/v1alpha1/access/-/target-preview

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取付费墙目标摘要与相关文章预览 operationId：GetPaywallTargetPreview。

参数	位置	必填	类型
type	query	True	string
name	query	True	string
limit	query	False	string

响应 default */*：PaywallTargetPreviewVo。

POST /apis/api.knowsphere.webjing.com/v1alpha1/access/-/verify-password

身份：公开路由，按具体操作校验；范围：市场版合同包含。 验证口令，成功后设置 cookie operationId：VerifyPassword。

请求 application/json：PasswordVerifyRequest。

GET /apis/api.knowsphere.webjing.com/v1alpha1/captcha/-/generate

身份：公开路由，按具体操作校验；范围：市场版合同包含。 生成验证码图片 operationId：GenerateCaptcha。

GET /apis/api.knowsphere.webjing.com/v1alpha1/columns

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取已启用专栏列表（自动过滤未启用和已归档专栏） operationId：ListPublicColumns。

响应 default */*：ColumnListResponse。

GET /apis/api.knowsphere.webjing.com/v1alpha1/columns/{name}

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取专栏详情 operationId：GetPublicColumnDetail。

参数	位置	必填	类型
name	path	True	string

响应 default */*：ColumnVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/columns/{name}/chapters

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取专栏章节列表（仅已发布章节） operationId：ListPublicColumnChapters。

参数	位置	必填	类型
name	path	True	string

响应 default */*：ChapterListResponse。

GET /apis/api.knowsphere.webjing.com/v1alpha1/comment-badges/-/resolve

身份：公开路由，按具体操作校验；范围：市场版合同包含。 按资源名批量解析评论/回复徽章 operationId：ResolveCommentBadgesByQuery。

响应 default */*：CommentBadgeResolveResponse。

POST /apis/api.knowsphere.webjing.com/v1alpha1/comment-badges/-/resolve

身份：公开路由，按具体操作校验；范围：市场版合同包含。 批量解析评论/回复徽章 operationId：ResolveCommentBadges。

请求 */*：CommentBadgeResolveRequest。

响应 default */*：CommentBadgeResolveResponse。

POST /apis/api.knowsphere.webjing.com/v1alpha1/comment-rewards/-/stats

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 批量获取评论打赏统计 operationId：BatchGetCommentRewardStatistics。

请求 */*：BatchStatsRequest。

GET /apis/api.knowsphere.webjing.com/v1alpha1/comment-rewards/{commentName}/stats

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 获取单条评论的打赏统计 operationId：GetCommentRewardStatistics。

参数	位置	必填	类型
commentName	path	True	string

GET /apis/api.knowsphere.webjing.com/v1alpha1/comments/-/config

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取评论组件配置 operationId：GetCommentConfig。

GET /apis/api.knowsphere.webjing.com/v1alpha1/comments/-/widget-status

身份：公开路由，按具体操作校验；范围：市场版合同包含。 检查 KnowSphere 评论组件是否为当前启用的评论组件 operationId：GetCommentWidgetStatus。

GET /apis/api.knowsphere.webjing.com/v1alpha1/distribution/-/check

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 检查推广码有效性 operationId：CheckPromotionCode。

参数	位置	必填	类型
code	query	True	string

响应 default */*：PromotionCodeCheckVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/edition

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取当前插件版本信息 operationId：GetEditionInfo。

响应 default */*：EditionInfoVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/edition/-/features

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取所有功能的详细状态 operationId：GetAllFeatureStatuses。

响应 default */*：FeatureStatusListVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/edition/-/upgrade

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 获取升级到 Pro 版本的信息 operationId：GetUpgradeInfo。

响应 default */*：UpgradeInfoVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/edition/{feature}/features

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取指定功能的详细状态 operationId：GetFeatureStatus。

参数	位置	必填	类型
feature	path	True	string

响应 default */*：FeatureStatusResult。

GET /apis/api.knowsphere.webjing.com/v1alpha1/open-api/-/profile

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 获取当前 API Token 信息 operationId：GetApiAccessProfile。

响应 default */*：ApiAccessProfileVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/open-api/orders

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 通过 API Token 获取订单列表 operationId：ListOpenApiOrders。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
status	query	False	string
productType	query	False	string
username	query	False	string
X-KnowSphere-Api-Key	header	False	string

响应 default */*：ApiOrderVoList。

GET /apis/api.knowsphere.webjing.com/v1alpha1/open-api/purchases

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 通过 API Token 获取已购内容列表 operationId：ListOpenApiPurchases。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
targetType	query	False	string
source	query	False	string
username	query	False	string
X-KnowSphere-Api-Key	header	False	string

响应 default */*：UserAccessVoList。

GET /apis/api.knowsphere.webjing.com/v1alpha1/open-api/stats/-/overview

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 通过 API Token 获取统计概览 operationId：GetOpenApiStatsOverview。

GET /apis/api.knowsphere.webjing.com/v1alpha1/payment-providers/{providerId}/callback

身份：公开路由，按具体操作校验；范围：市场版合同包含。 处理支付提供方 GET 回调 operationId：HandlePaymentProviderCallbackByGet。

参数	位置	必填	类型
providerId	path	True	string

POST /apis/api.knowsphere.webjing.com/v1alpha1/payment-providers/{providerId}/callback

身份：公开路由，按具体操作校验；范围：市场版合同包含。 处理支付提供方 POST 回调 operationId：HandlePaymentProviderCallbackByPost。

参数	位置	必填	类型
providerId	path	True	string

GET /apis/api.knowsphere.webjing.com/v1alpha1/paywall/-/target-preview

身份：公开路由，按具体操作校验；范围：市场版合同包含。 获取付费墙目标摘要与相关文章预览（公开路由） operationId：GetPaywallTargetPreviewPublic。

参数	位置	必填	类型
type	query	True	string
name	query	True	string
limit	query	False	string

响应 default */*：PaywallTargetPreviewVo。

GET /apis/api.knowsphere.webjing.com/v1alpha1/ratings/-/reviews

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 分页获取审核通过的文字评价 operationId：ListApprovedContentRatingReviews。

参数	位置	必填	类型
contentType	query	True	string
contentName	query	True	string
page	query	False	string
size	query	False	string

GET /apis/api.knowsphere.webjing.com/v1alpha1/ratings/-/stats

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 获取内容评分统计 operationId：GetContentRatingStatistics。

参数	位置	必填	类型
contentType	query	True	string
contentName	query	True	string

GET /apis/api.knowsphere.webjing.com/v1alpha1/ratings/-/top

身份：公开路由，按具体操作校验；范围：main/Pro 对照，市场版不包含。 获取评分 Top 列表 operationId：ListTopRatedContent。

参数	位置	必填	类型
contentType	query	False	string
limit	query	False	string

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/activity-gifts/-/claims

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的活动礼包领取记录 operationId：ListMyActivityGiftClaims。

响应 default */*：Array<GiftClaimRecord>。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/activity-gifts/-/overview

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的待领取活动和领取记录 operationId：GetMyActivityGiftOverview。

响应 default */*：UcActivityGiftOverviewVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/activity-gifts/{name}/claim

身份：当前登录用户；范围：市场版合同包含。 领取指定活动礼包 operationId：ClaimActivityGift。

参数	位置	必填	类型
name	path	True	string

响应 default */*：GiftClaimResultVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/author-contents/-/mine

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户绑定的作者内容 operationId：ListMyAuthorContents。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
targetType	query	False	string
targetName	query	False	string
authorProfileName	query	False	string
role	query	False	string
keyword	query	False	string

响应 default */*：AuthorUcEndpoint.AuthorContentItemList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/author-profile/-/mine

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的作者档案 operationId：GetMyAuthorProfile。

响应 default */*：AuthorProfileView。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/author-revenues/-/mine

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的作者收益 operationId：ListMyAuthorRevenues。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
keyword	query	False	string
authorProfileName	query	False	string
targetType	query	False	string
phase	query	False	string
sourceType	query	False	string

响应 default */*：AuthorUcEndpoint.AuthorRevenueItemList。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/checkin

身份：当前登录用户；范围：市场版合同包含。 执行每日签到 operationId：DoCheckin。

响应 default */*：CheckinResultVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/checkin/status

身份：当前登录用户；范围：市场版合同包含。 获取当前用户签到状态 operationId：GetMyCheckinStatus。

响应 default */*：CheckinStatusVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/columns/-/purchased

身份：当前登录用户；范围：市场版合同包含。 获取用户已购专栏列表 operationId：ListPurchasedColumns。

响应 default */*：PurchasedColumnListResponse。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/columns/{name}/drip-status

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取用户在指定专栏的滴灌解锁状态 operationId：GetColumnDripStatus。

参数	位置	必填	类型
name	path	True	string

响应 default */*：UserDripStatusVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/columns/{name}/progress

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取用户对指定专栏的学习进度 operationId：GetColumnProgress。

参数	位置	必填	类型
name	path	True	string

响应 default */*：UserProgressVo。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/columns/{name}/progress

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 更新用户学习进度 operationId：UpdateColumnProgress。

参数	位置	必填	类型
name	path	True	string

请求 */*：UpdateProgressRequest。

响应 default */*：UserProgressVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/comment-rewards

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 发起打赏（创建订单） operationId：CreateCommentReward。

请求 */*：CreateRewardRequest。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/comment-rewards/-/my

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 查询我的打赏记录 operationId：ListMyCommentRewards。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
commentName	query	False	string

响应 default */*：CommentRewardVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/coupons

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的优惠券列表 operationId：ListMyCoupons。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/coupons/-/available

身份：当前登录用户；范围：市场版合同包含。 获取当前订单场景可用的优惠券列表 operationId：ListAvailableCoupons。

参数	位置	必填	类型
productType	query	False	string
amount	query	False	string

响应 default */*：string。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/dashboard-preference

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的个人中心入口排序偏好 operationId：GetMyDashboardPreference。

响应 default */*：DashboardPreferenceResponse。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/dashboard-preference

身份：当前登录用户；范围：市场版合同包含。 更新当前用户的个人中心入口排序偏好 operationId：UpdateMyDashboardPreference。

请求 */*：DashboardPreferenceRequest。

响应 default */*：DashboardPreferenceResponse。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/distribution/-/bind

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 绑定推广关系 operationId：BindDistribution。

请求 */*：BindDistributorRequest。

响应 default */*：BindDistributorResponse。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distribution/-/settings

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取分销系统设置 operationId：GetDistributionSettings。

响应 default */*：DistributionSettingsVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/apply

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 申请成为分销员 operationId：ApplyDistributor。

请求 */*：DistributorApplyRequest。

响应 default */*：Distributor。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/commissions

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的佣金明细 operationId：ListMyCommissions。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
phase	query	False	string

响应 default */*：DistributionVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/profile

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的分销员信息 operationId：GetDistributorProfile。

响应 default */*：DistributorVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/statistics

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的分销统计数据 operationId：GetMyDistributorStatistics。

响应 default */*：DistributionStatisticsVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/team

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的团队成员 operationId：ListMyTeam。

响应 default */*：TeamMemberListVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/withdraw

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 申请提现 operationId：ApplyWithdraw。

请求 */*：WithdrawApplyRequest。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/distributors/-/withdrawals

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户的提现记录 operationId：ListMyWithdrawals。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/exchange-orders

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取我的兑换订单列表 operationId：ListMyExchangeOrders。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>

响应 default */*：ExchangeOrderVoList。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/exchange-orders

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 兑换商品 operationId：ExchangeProduct。

请求 */*：ExchangeRequest。

响应 default */*：ExchangeOrderVo。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/exchange-orders/{name}/confirm

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 确认收货 operationId：ConfirmReceipt。

参数	位置	必填	类型
name	path	True	string

响应 default */*：ExchangeOrderVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/featuresettings

身份：当前登录用户；范围：市场版合同包含。 获取用户中心可见的 Pro 功能设置 operationId：GetUcFeatureSettings。

响应 default */*：FeatureSettingsResponse。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/membership

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的会员状态 operationId：GetMyMembership。

响应 default */*：MembershipVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/membership/plans

身份：当前登录用户；范围：市场版合同包含。 获取当前用户可见的会员套餐列表 operationId：ListMembershipPlansForUser。

响应 default */*：MembershipPlanListVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/orders

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的订单列表 operationId：ListMyOrders。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
status	query	False	string
productType	query	False	string
username	query	False	string

响应 default */*：OrderVoList。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/orders

身份：当前登录用户；范围：市场版合同包含。 创建订单 operationId：CreateOrder。

请求 */*：CreateOrderRequest。

响应 default */*：OrderVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/orders/{orderNo}

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的订单详情 operationId：GetMyOrder。

参数	位置	必填	类型
orderNo	path	True	string

响应 default */*：OrderVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/orders/{orderNo}/cancel

身份：当前登录用户；范围：市场版合同包含。 取消当前用户的待支付订单 operationId：CancelOrder。

参数	位置	必填	类型
orderNo	path	True	string

响应 default */*：OrderVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/orders/{orderNo}/payments

身份：当前登录用户；范围：市场版合同包含。 发起订单支付 operationId：InitiateOrderPayment。

参数	位置	必填	类型
orderNo	path	True	string

请求 */*：InitiatePaymentRequest。

响应 default */*：PaymentInitVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 创建付费问答问题 operationId：CreatePaidQaQuestion。

请求 */*：CreateQuestionRequest。

响应 default */*：QuestionCreateResultVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/-/my

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取我的问答列表 operationId：ListMyPaidQaQuestions。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
status	query	False	string
asker	query	False	string
answerer	query	False	string
keyword	query	False	string
startTime	query	False	string
endTime	query	False	string

响应 default */*：QuestionVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/-/watchable

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取可围观问题列表 operationId：ListPaidQaQuestions_1。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
status	query	False	string
asker	query	False	string
answerer	query	False	string
keyword	query	False	string
startTime	query	False	string
endTime	query	False	string

响应 default */*：QuestionVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/{name}

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取问题详情（用户端） operationId：GetPaidQaQuestionForUser。

参数	位置	必填	类型
name	path	True	string

响应 default */*：QuestionVo。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/{name}

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 编辑我的问题 operationId：UpdateMyPaidQaQuestion。

参数	位置	必填	类型
name	path	True	string

请求 */*：UpdateQuestionRequest。

响应 default */*：QuestionVo。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/{name}/accept

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 采纳回答 operationId：AcceptPaidQaAnswer。

参数	位置	必填	类型
name	path	True	string

响应 default */*：QuestionVo。

PUT /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/{name}/close

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 关闭我的问题 operationId：CloseMyPaidQaQuestion。

参数	位置	必填	类型
name	path	True	string

响应 default */*：QuestionVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/paid-qa-questions/{name}/watch

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 创建围观订单 operationId：CreatePaidQaWatchOrder。

参数	位置	必填	类型
name	path	True	string

响应 default */*：OrderVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/payments/-/methods

身份：当前登录用户；范围：市场版合同包含。 获取当前可用的支付方式列表 operationId：ListAvailablePaymentMethods。

响应 default */*：PaymentMethodVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/payments/{orderNo}/status

身份：当前登录用户；范围：市场版合同包含。 查询订单支付状态 operationId：GetOrderPaymentStatus。

参数	位置	必填	类型
orderNo	path	True	string

响应 default */*：PaymentStatusVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/products

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取积分商城商品列表（用户端） operationId：ListMallProductsForUser。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
productType	query	False	string

响应 default */*：MallProductVoList。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/products/{name}

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取商品详情（用户端） operationId：GetMallProductForUser。

参数	位置	必填	类型
name	path	True	string

响应 default */*：MallProductVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/purchases

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的已购内容列表 operationId：ListMyPurchases。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
targetType	query	False	string
source	query	False	string
username	query	False	string

响应 default */*：UserAccessVoList。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/ratings

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 提交或更新评分 operationId：SubmitContentRating。

请求 */*：SubmitRatingRequest。

DELETE /apis/uc.api.knowsphere.webjing.com/v1alpha1/ratings/-/my

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 删除自己的评分 operationId：DeleteUserContentRating。

参数	位置	必填	类型
contentType	query	True	string
contentName	query	True	string

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/ratings/-/my

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 查询自己的评分 operationId：GetUserContentRating。

参数	位置	必填	类型
contentType	query	True	string
contentName	query	True	string

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/tasks

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 获取当前用户可用的任务列表 operationId：ListMyTasks。

响应 default */*：TaskListVo。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/tasks/{taskName}/claim

身份：当前登录用户；范围：main/Pro 对照，市场版不包含。 领取任务奖励 operationId：ClaimTaskReward。

参数	位置	必填	类型
taskName	path	True	string

响应 default */*：ClaimRewardVo。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/wallet

身份：当前登录用户；范围：市场版合同包含。 获取或创建当前用户的钱包 operationId：GetOrCreateMyWallet。

POST /apis/uc.api.knowsphere.webjing.com/v1alpha1/wallet/recharge

身份：当前登录用户；范围：市场版合同包含。 使用卡密充值 operationId：RechargeByCard。

请求 */*：RechargeRequest。

GET /apis/uc.api.knowsphere.webjing.com/v1alpha1/wallet/transactions

身份：当前登录用户；范围：市场版合同包含。 获取当前用户的钱包交易记录 operationId：ListMyTransactions。

参数	位置	必填	类型
page	query	False	integer:int32
size	query	False	integer:int32
labelSelector	query	False	Array<string>
fieldSelector	query	False	Array<string>
sort	query	False	Array<string>
type	query	False	string
username	query	False	string

响应 default */*：WalletTransactionList。

请求与响应模型

字段只来自上述路由引用的模型；金额与身份仍以服务端校验为准。

模型 AccessCheckVo

字段	类型	必填	说明
grantedBy	string	False	授权方式类型（granted 时有值，标识哪种解锁方式放行）
hasAccess	boolean	False	是否有访问权限
previewLength	integer:int32	False	试看字数
previewRatio	integer:int32	False	试看比例 0-100
purchaseTargetName	string	False	下单/购买应使用的目标名称
purchaseTargetType	string	False	下单/购买应使用的目标类型
resolvedTargetName	string	False	命中的规则目标名称
resolvedTargetType	string	False	命中的规则目标类型
unlockMethods	Array<UnlockMethodVo>	False	可用的解锁方式列表（拒绝时返回）

模型 ActivityGiftStatusVo

字段	类型	必填	说明
campaignName	string	False
claimPhase	string	False
claimTime	string:date-time	False
claimed	boolean	False
cover	string	False	礼包宣传图地址，可为空
description	string	False
displayName	string	False
distributionMode	string	False
eligible	boolean	False
endTime	string:date-time	False
giftItems	Array<GiftItem>	False
startTime	string:date-time	False
timeStatus	string	False

模型 AnonymousCommentAccessRequest

字段	类型	必填	说明
email	string	False
name	string	False
type	string	False

模型 ApiAccessProfileVo

字段	类型	必填	说明
displayName	string	False	密钥显示名称
expiresAt	string:date-time	False	过期时间
name	string	False	密钥名称
scopes	Array<string>	False	授权范围

模型 ApiOrderVo

字段	类型	必填	说明
amount	number	False	订单金额
completedAt	string:date-time	False	完成时间
createdAt	string:date-time	False	创建时间
discountAmount	number	False	优惠金额
name	string	False	资源名称
orderNo	string	False	订单号
paidAmount	number	False	实付金额
paidAt	string:date-time	False	支付时间
paymentChannel	string	False	支付渠道
phase	string	False	订单状态
productId	string	False	商品标识
productTitle	string	False	商品标题
productType	string	False	商品类型
username	string	False	用户名

模型 ApiOrderVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<ApiOrderVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 AuthorContentItem

字段	类型	必填	说明
bindingName	string	False
createdAt	string:date-time	False
previewPath	string	False
role	string	False
targetDisplayName	string	False
targetName	string	False
targetType	string	False

模型 AuthorDisplayVo

字段	类型	必填	说明
authorProfileName	string	False	作者档案名称
authorType	string	False	作者类型
avatar	string	False	头像
bio	string	False	简介
displayName	string	False	展示名
displayOrder	integer:int32	False	展示顺序
primary	boolean	False	是否主作者
role	string	False	角色
title	string	False	头衔
username	string	False	内部作者用户名
virtualBinding	boolean	False	是否为旧字段回退生成的虚拟绑定

模型 AuthorProfileView

字段	类型	必填	说明
avatar	string	False
bio	string	False
displayName	string	False
name	string	False
slug	string	False
title	string	False

模型 AuthorRevenueItem

字段	类型	必填	说明
createdAt	string:date-time	False
orderName	string	False
phase	string	False
previewPath	string	False
recordName	string	False
settleAmount	number	False
snapshotAuthorDisplayName	string	False
snapshotRole	string	False
sourceType	string	False
targetDisplayName	string	False
targetName	string	False
targetType	string	False

模型 AuthorUcEndpoint.AuthorContentItemList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<AuthorContentItem>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 AuthorUcEndpoint.AuthorRevenueItemList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<AuthorRevenueItem>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 BatchStatsRequest

字段	类型	必填	说明
commentNames	Array<string>	False

模型 BindDistributorRequest

字段	类型	必填	说明
productId	string	False
productType	string	False
promotionCode	string	False
source	string	False

模型 BindDistributorResponse

字段	类型	必填	说明
distributorUsername	string	False
message	string	False
success	boolean	False

模型 ChapterDripItem

字段	类型	必填	说明
chapterName	string	False
chapterTitle	string	False
dripStatus	string	False
unlockTime	string:date-time	False

模型 ChapterListResponse

字段	类型	必填	说明
items	Array<ChapterVo>	False
total	integer:int32	False

模型 ChapterVo

字段	类型	必填	说明
authorUsername	string	False
dripStatus	string	False
isFreePreview	boolean	False
isPendingUnlock	boolean	False
isRead	boolean	False
name	string	False
permalink	string	False
priority	integer:int32	False
publishTime	string:date-time	False
published	boolean	False
slug	string	False
tags	Array<string>	False
title	string	False
unlockTime	string:date-time	False

模型 CheckinResultVo

字段	类型	必填	说明
bonus	integer:int32	False	连续签到额外奖励积分
consecutiveDays	integer:int32	False	连续签到天数
points	integer:int32	False	本次获得积分

模型 CheckinStatusVo

字段	类型	必填	说明
checkedDays	Array<integer:int32>	False	当月已签到日期列表
checkinPoints	integer:int32	False	每日签到基础积分
consecutiveDays	integer:int32	False	连续签到天数
continuousBonus	integer:int32	False	连续签到每日额外加成
todayChecked	boolean	False	今日是否已签到

模型 ClaimRewardVo

字段	类型	必填	说明
message	string	False	提示消息
rewardType	string	False	奖励类型
rewardValue	string	False	奖励值
success	boolean	False	是否成功

模型 ColumnListResponse

字段	类型	必填	说明
items	Array<ColumnVo>	False
total	integer:int32	False

模型 ColumnVo

字段	类型	必填	说明
allowChapterPurchase	boolean	False
articleCount	integer:int32	False
authorUsername	string	False
authors	Array<AuthorDisplayVo>	False
categoryDisplayName	string	False
categoryName	string	False
chapterPrice	number	False
cover	string	False
description	string	False
displayName	string	False
dripEnabled	boolean	False
enabled	boolean	False
name	string	False
originalPrice	number	False
phase	string	False
price	number	False
sortOrder	integer:int32	False
subscriberCount	integer:int32	False
totalViews	integer:int64	False

模型 CommentBadgeResolveItem

字段	类型	必填	说明
anonymousEmailHash	string	False
resourceName	string	False
userId	string	False

模型 CommentBadgeResolveRequest

字段	类型	必填	说明
items	Array<CommentBadgeResolveItem>	False

模型 CommentBadgeResolveResponse

字段	类型	必填	说明
badges	object	False

模型 CommentRewardVo

字段	类型	必填	说明
amount	number	False
commentName	string	False
commentOwner	string	False
commentSnippet	string	False
createdAt	string:date-time	False
name	string	False
orderName	string	False
status	string	False

模型 CommentRewardVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<CommentRewardVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 CreateOrderRequest

字段	类型	必填	说明
couponName	string	False	优惠券名称
productId	string	True	商品ID/名称
productTitle	string	False	商品标题
productType	string	True	商品类型

模型 CreateQuestionRequest

字段	类型	必填	说明
allowWatch	boolean	False
content	string	False
price	number	False
title	string	False
watchPrice	number	False

模型 CreateRewardRequest

字段	类型	必填	说明
amount	number	False
commentName	string	False

模型 DashboardPreferenceRequest

字段	类型	必填	说明
consoleModuleOrder	Array<string>	False
displayPreferences	object	False
layoutPreferences	object	False
ucEntryOrder	Array<string>	False

模型 DashboardPreferenceResponse

字段	类型	必填	说明
consoleModuleOrder	Array<string>	False
displayPreferences	object	False
layoutPreferences	object	False
ucEntryOrder	Array<string>	False

模型 DistributedItem

字段	类型	必填	说明
description	string	False	权益描述快照
errorMessage	string	False	错误信息
rewardType	string	False	奖励类型
rewardValue	string	False	奖励值
success	boolean	False	是否成功

模型 DistributionSettingsVo

字段	类型	必填	说明
applyCondition	string	False
enabled	boolean	False
level1Rate	number	False
level2Rate	number	False
minWithdrawAmount	number	False
settlementDelayDays	integer:int32	False
withdrawMethods	Array<string>	False

模型 DistributionStatisticsVo

字段	类型	必填	说明
directCount	integer:int32	False
monthCommission	number	False
orderCount	integer:int32	False
pendingCommission	number	False
teamCount	integer:int32	False
todayCommission	number	False
todayNewCount	integer:int32	False
totalCommission	number	False
withdrawnAmount	number	False

模型 DistributionVo

字段	类型	必填	说明
buyerDisplayName	string	False
buyerUsername	string	False
createdAt	string:date-time	False
level1Commission	number	False
level1Username	string	False
level2Commission	number	False
level2Username	string	False
name	string	False
orderAmount	number	False
orderNo	string	False
phase	string	False
productTitle	string	False
productType	string	False
settledAt	string:date-time	False

模型 DistributionVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<DistributionVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 Distributor

字段	类型	必填	说明
apiVersion	string	True
approved	boolean	False
availableBalance	number	False
disabled	boolean	False
kind	string	True
levelOrDefault	string	False
metadata	Metadata	True
pending	boolean	False
rejected	boolean	False
spec	DistributorSpec	True
status	DistributorStatus	False
statusOrDefault	DistributorStatus	False

模型 DistributorApplyRequest

字段	类型	必填	说明
applyReason	string	False
contactInfo	string	False
promotionCode	string	False
realName	string	False

模型 DistributorSpec

字段	类型	必填	说明
applyReason	string	False	申请理由
contactInfo	string	False	联系方式
level	string	False	分销员等级
parentUsername	string	False	上级分销员用户名
promotionCode	string	True	推广码（唯一）
realName	string	False	真实姓名（提现用）
rejectReason	string	False	拒绝理由
username	string	True	用户名

模型 DistributorStatus

字段	类型	必填	说明
approvedAt	string:date-time	False	审核通过时间
directCount	integer:int32	False	直推人数
orderCount	integer:int32	False	推广订单数
pendingCommission	number	False	待结算佣金
phase	string	False	状态
rejectedAt	string:date-time	False	审核拒绝时间
teamCount	integer:int32	False	团队总人数
totalCommission	number	False	累计佣金
withdrawnAmount	number	False	已提现金额

模型 DistributorVo

字段	类型	必填	说明
applyReason	string	False
approvedAt	string:date-time	False
avatar	string	False
contactInfo	string	False
createdAt	string:date-time	False
directCount	integer:int32	False
displayName	string	False
level	string	False
name	string	False
orderCount	integer:int32	False
parentUsername	string	False
pendingCommission	number	False
phase	string	False
promotionCode	string	False
realName	string	False
rejectReason	string	False
teamCount	integer:int32	False
totalCommission	number	False
username	string	False
withdrawnAmount	number	False

模型 EditionInfoVo

字段	类型	必填	说明
displayName	string	False
edition	string	False
features	Array<string>	False
pro	boolean	False

模型 ExchangeOrderVo

字段	类型	必填	说明
completedAt	string:date-time	False	完成时间
createdAt	string:date-time	False	创建时间
name	string	False	订单名称（唯一标识）
orderNo	string	False	订单号
phase	string	False	订单状态
pointsSpent	integer:int32	False	消耗积分
productDisplayName	string	False	商品显示名称
productName	string	False	商品名称（Extension name）
productType	string	False	商品类型
shippedAt	string:date-time	False	发货时间
shippingAddress	ShippingAddressVo	False
shippingCompany	string	False	快递公司
trackingNumber	string	False	快递单号
username	string	False	用户名

模型 ExchangeOrderVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<ExchangeOrderVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 ExchangeRequest

字段	类型	必填	说明
productName	string	False
shippingAddress	ShippingAddress	False

模型 FeatureGroupVo

字段	类型	必填	说明
enabledCount	integer:int32	False
features	Array<string>	False
id	string	False
name	string	False
totalCount	integer:int32	False

模型 FeatureInfo

字段	类型	必填	说明
available	boolean	False
dependencies	Array<string>	False
dependents	Array<string>	False
description	string	False
enabled	boolean	False
group	string	False
id	string	False
name	string	False
proOnly	boolean	False
unavailableReason	string	False

模型 FeatureSettingsResponse

字段	类型	必填	说明
edition	string	False
features	Array<FeatureInfo>	False
groups	Array<FeatureGroupVo>	False
pro	boolean	False

模型 FeatureStatusListVo

字段	类型	必填	说明
edition	string	False
features	Array<FeatureStatusResult>	False
pro	boolean	False

模型 FeatureStatusResult

字段	类型	必填	说明
available	boolean	False
feature	string	False
info	FeatureInfo	False
reason	string	False
status	string	False
upgradeUrl	string	False

模型 GiftClaimRecord

字段	类型	必填	说明
allSuccess	boolean	False
apiVersion	string	True
kind	string	True
metadata	Metadata	True
partialSuccess	boolean	False
spec	GiftClaimRecordSpec	True
status	GiftClaimRecordStatus	False
statusOrDefault	GiftClaimRecordStatus	False
userClaimKey	string	False

模型 GiftClaimRecordSpec

字段	类型	必填	说明
campaignDescription	string	False	领取时的活动描述
campaignDisplayName	string	False	领取时的活动名称
campaignEndTime	string:date-time	False	领取时的活动结束时间
campaignName	string	False	活动标识（GiftPackage Extension name）
campaignStartTime	string:date-time	False	领取时的活动开始时间
claimTime	string:date-time	False	领取时间
distributedItems	Array<DistributedItem>	False	已发放项目
username	string	True	用户名

模型 GiftClaimRecordStatus

字段	类型	必填	说明
completedAt	string:date-time	False	完成时间
failedItems	Array<string>	False	失败项目列表
phase	string	False	领取状态

模型 GiftClaimResultVo

字段	类型	必填	说明
distributedItems	Array<DistributedItem>	False	已发放项目
message	string	False	消息
phase	string	False	领取状态
success	boolean	False	是否成功

模型 GiftItem

字段	类型	必填	说明
description	string	False	项目描述
rewardType	string	False	奖励类型
rewardValue	string	False	奖励值（优惠券名称/积分数/天数）

模型 InitiatePaymentRequest

字段	类型	必填	说明
paymentMethod	string	True	支付方式 ID
returnUrl	string	False	支付完成后的返回地址
scene	string	False	支付场景

模型 MallProductVo

字段	类型	必填	说明
cover	string	False	封面图片
createdAt	string:date-time	False	创建时间
description	string	False	商品描述
displayName	string	False	商品显示名称
enabled	boolean	False	是否启用
exchangeLimit	integer:int32	False	每人兑换上限
images	Array<string>	False	商品图片
name	string	False	商品名称（唯一标识）
outOfStock	boolean	False	是否售罄
pointsCost	integer:int32	False	所需积分
productType	string	False	商品类型
remainingStock	integer:int32	False	剩余库存
rewardType	string	False	奖励类型
rewardValue	string	False	奖励值（优惠券名称/天数/积分数）
shippingNotes	string	False	发货说明
sortOrder	integer:int32	False	排序权重
specifications	string	False	规格说明
stock	integer:int32	False	库存数量
totalExchanged	integer:int32	False	累计兑换数量

模型 MallProductVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<MallProductVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 MembershipPlanListVo

字段	类型	必填	说明
items	Array<MembershipPlanVo>	False	套餐列表
total	integer:int32	False	总数

模型 MembershipPlanVo

字段	类型	必填	说明
allBenefits	Array<string>	False	完整权益列表（自动生成 + 等级权益 + 套餐权益合并）
benefits	Array<string>	False	套餐自身权益列表（手动配置）
description	string	False	套餐描述
durationDays	integer:int32	False	有效天数
durationType	string	False	时长类型
levelBenefits	Array<string>	False	等级权益列表（来自关联等级的配置）
levelColor	string	False	等级主题色
levelDisplayName	string	False	会员等级显示名称
levelIcon	string	False	等级图标
levelName	string	False	会员等级名称（metadata.name）
levelPriority	integer:int32	False	会员等级优先级
name	string	False	资源名称
originalPrice	number	False	原价
price	number	False	价格
recommended	boolean	False	是否推荐
title	string	False	套餐标题

模型 MembershipVo

字段	类型	必填	说明
active	boolean	False	是否为会员
autoRenew	boolean	False	是否自动续费
benefits	Array<string>	False	权益列表（自动生成 + 等级配置的权益合并）
expireAt	string:date-time	False	过期时间
levelColor	string	False	会员等级主题色
levelDisplayName	string	False	会员等级显示名称
levelIcon	string	False	会员等级图标
levelName	string	False	会员等级名称（metadata.name）
levelPriority	integer:int32	False	会员等级优先级
planName	string	False	套餐名称
remainingDays	integer:int32	False	剩余天数，-1表示永久
startAt	string:date-time	False	开始时间

模型 Metadata

字段	类型	必填	说明
annotations	object	False	Annotations are like key-value format.
creationTimestamp	string:date-time	False	Creation timestamp of the Extension.
deletionTimestamp	string:date-time	False	Deletion timestamp of the Extension.
finalizers	Array<string>	False
generateName	string	False	The name field will be generated automatically according to the given generateName field
labels	object	False	Labels are like key-value format.
name	string	True	Metadata name
version	integer:int64	False	Current version of the Extension. It will be bumped up every update.

模型 OrderVo

字段	类型	必填	说明
amount	number	False	订单金额
completedAt	string:date-time	False	完成时间
createdAt	string:date-time	False	创建时间
discountAmount	number	False	优惠金额
name	string	False	资源名称
orderNo	string	False	订单号
paidAmount	number	False	实付金额
paidAt	string:date-time	False	支付时间
paymentChannel	string	False	支付渠道
paymentNo	string	False	支付流水号
phase	string	False	订单状态
productDisplayName	string	False	商品展示名称
productId	string	False	商品ID
productPermalink	string	False	商品预览链接
productTitle	string	False	商品标题
productType	string	False	商品类型
refundedAt	string:date-time	False	退款时间
remark	string	False	订单备注
username	string	False	用户名

模型 OrderVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<OrderVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 PasswordVerifyRequest

字段	类型	必填	说明
password	string	False
targetName	string	False
targetType	string	False

模型 PaymentInitVo

字段	类型	必填	说明
amount	number	False	支付金额
expireAt	integer:int64	False	过期时间戳
orderNo	string	False	订单号
paymentChannel	string	False	支付渠道
paymentMethod	string	False	支付方式
paymentPageContent	string	False	支付页面内容（如支付宝表单 HTML）
paymentParams	object	False	支付参数（小程序/APP支付时使用）
paymentUrl	string	False	支付链接（H5/PC跳转支付时使用）
phase	string	False	订单阶段
qrCode	string	False	二维码内容（扫码支付时使用）

模型 PaymentMethodVo

字段	类型	必填	说明
description	string	False	支付方式说明
enabled	boolean	False	是否启用
icon	string	False	支付方式图标
id	string	False	支付方式 ID
name	string	False	支付方式名称
providerType	string	False	提供方类型

模型 PaymentMethodVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<PaymentMethodVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 PaymentStatusVo

字段	类型	必填	说明
gatewayStatus	string	False	网关状态
orderNo	string	False	订单号
paidAt	string	False	支付时间
paymentChannel	string	False	支付渠道
paymentNo	string	False	第三方支付流水号
phase	string	False	订单状态

模型 PaywallRelatedPostSummary

字段	类型	必填	说明
cover	string	False	封面图
excerpt	string	False	文章摘要
freePreview	boolean	False	是否为免费试看文章
name	string	False	文章名称
permalink	string	False	文章链接
publishTime	string:date-time	False	发布时间
title	string	False	文章标题

模型 PaywallTargetPreviewVo

字段	类型	必填	说明
context	PaywallTargetSummary	False
relatedPosts	Array<PaywallRelatedPostSummary>	False	用于预览的相关文章列表
target	PaywallTargetSummary	False

模型 PaywallTargetSummary

字段	类型	必填	说明
allowChapterPurchase	boolean	False	是否允许单章购买
articleCount	integer:int32	False	文章数量
chapterPrice	number	False	单章价格
cover	string	False	封面图
description	string	False	描述信息
displayName	string	False	展示名称
label	string	False	目标标签
name	string	False	目标名称
permalink	string	False	跳转链接
type	string	False	目标类型

模型 PromotionCodeCheckVo

字段	类型	必填	说明
distributorUsername	string	False
level	string	False
valid	boolean	False

模型 PublicCommentBadgeLevel

字段	类型	必填	说明
anonymousEmailHashes	Array<string>	False
backgroundColor	string	False
borderColor	string	False
key	string	False
label	string	False
textColor	string	False

模型 PurchasedColumnListResponse

字段	类型	必填	说明
items	Array<PurchasedColumnVo>	False
total	integer:int32	False

模型 PurchasedColumnVo

字段	类型	必填	说明
articleCount	integer:int32	False
authorUsername	string	False
authors	Array<AuthorDisplayVo>	False
categoryName	string	False
completedCount	integer:int32	False
cover	string	False
description	string	False
displayName	string	False
lastReadAt	string:date-time	False
lastReadPostName	string	False
name	string	False
originalPrice	number	False
price	number	False
progressPercent	integer:int32	False
totalCount	integer:int32	False

模型 QuestionCreateResultVo

字段	类型	必填	说明
order	OrderVo	False
question	QuestionVo	False

模型 QuestionVo

字段	类型	必填	说明
acceptedAt	string:date-time	False	采纳时间
allowWatch	boolean	False	是否允许围观
answer	string	False	回答内容
answeredAt	string:date-time	False	回答时间
answerer	string	False	回答者用户名
answererRevenue	number	False	回答者收入
askedAt	string:date-time	False	提问时间
asker	string	False	提问者用户名
authors	Array<AuthorDisplayVo>	False	作者展示列表
content	string	False	问题内容
hasAccess	boolean	False	当前用户是否有访问权限
name	string	False	资源名称
paidAt	string:date-time	False	支付时间
phase	string	False	状态
platformRevenue	number	False	平台收入
price	number	False	提问价格
title	string	False	问题标题
totalRevenue	number	False	总收入
watchCount	integer:int32	False	围观次数
watchPrice	number	False	围观价格

模型 QuestionVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<QuestionVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 RechargeRequest

字段	类型	必填	说明
cardCode	string	False

模型 ShippingAddress

字段	类型	必填	说明
address	string	True	详细地址
city	string	True	市
district	string	True	区
phone	string	True	电话
province	string	True	省
recipientName	string	True	收件人

模型 ShippingAddressVo

字段	类型	必填	说明
address	string	False	详细地址
city	string	False	市
district	string	False	区
phone	string	False	电话
province	string	False	省
recipientName	string	False	收件人

模型 SubmitRatingRequest

字段	类型	必填	说明
comment	string	False
contentName	string	False
contentType	string	False
rating	integer:int32	False

模型 TaskListVo

字段	类型	必填	说明
tasks	Array<TaskVo>	False	任务列表
total	integer:int32	False	总数

模型 TaskVo

字段	类型	必填	说明
claimedCount	integer:int32	False	领取人数
completedCount	integer:int32	False	完成人数
description	string	False	任务描述
displayName	string	False	任务显示名称
enabled	boolean	False	是否启用
expireAt	string:date-time	False	过期时间
name	string	False	任务名称（唯一标识）
rewardDisplay	string	False	奖励显示文本
rewardType	string	False	奖励类型
rewardValue	string	False	奖励值
sortOrder	integer:int32	False	排序顺序
startAt	string:date-time	False	开始时间
targetCount	integer:int32	False	目标次数
targetName	string	False	目标名称
targetProgress	integer:int32	False	用户目标进度
targetType	string	False	目标类型
triggerType	string	False	触发类型
type	string	False	任务类型
userProgress	integer:int32	False	用户当前进度
userStatus	string	False	用户任务状态

模型 TeamMemberListVo

字段	类型	必填	说明
items	Array<TeamMemberVo>	False
total	integer:int32	False

模型 TeamMemberVo

字段	类型	必填	说明
avatar	string	False
bindAt	string:date-time	False
contribution	number	False
displayName	string	False
level	string	False
username	string	False

模型 UcActivityGiftOverviewVo

字段	类型	必填	说明
activities	Array<ActivityGiftStatusVo>	False
claimRecords	Array<GiftClaimRecord>	False
pendingCount	integer:int64	False

模型 UnlockMethodVo

字段	类型	必填	说明
allowedLevels	Array<string>	False	允许的会员等级（membership 类型，空=所有会员）
originalPrice	number	False	原价（paid 类型）
price	number	False	价格（paid 类型）
requiredLevel	string	False	所需会员等级（level 类型）
scheduledAccessAt	string:date-time	False	定时开放时间（scheduled 类型）
type	string	False	解锁方式类型
validDays	integer:int32	False	有效天数，0=永久（paid 类型）

模型 UpdateProgressRequest

字段	类型	必填	说明
postName	string	False

模型 UpdateQuestionRequest

字段	类型	必填	说明
allowWatch	boolean	False
content	string	False
price	number	False
title	string	False
watchPrice	number	False

模型 UpgradeInfoVo

字段	类型	必填	说明
benefits	Array<string>	False
canUpgrade	boolean	False
currentDisplayName	string	False
currentEdition	string	False
targetDisplayName	string	False
targetEdition	string	False
upgradeUrl	string	False

模型 UserAccessVo

字段	类型	必填	说明
acquireType	string	False	获取方式
effectiveAt	string:date-time	False	生效时间
expireAt	string:date-time	False	失效时间
expired	boolean	False	是否已过期
name	string	False	访问记录名称
orderCompletedAt	string:date-time	False	订单完成时间
orderNo	string	False	订单号
permalink	string	False	预览链接
productName	string	False	商品标识
productTitle	string	False	商品展示名称
productType	string	False	商品类型
purchasedAt	string:date-time	False	购买时间
username	string	False	用户名

模型 UserAccessVoList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<UserAccessVo>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 UserDripStatusVo

字段	类型	必填	说明
chapters	Array<ChapterDripItem>	False
nextUnlockTime	string:date-time	False
subscriptionAnchor	string:date-time	False
totalCount	integer:int32	False
unlockedCount	integer:int32	False

模型 UserProgressVo

字段	类型	必填	说明
columnName	string	False
completedCount	integer:int32	False
lastReadAt	string:date-time	False
lastReadPostName	string	False
progressPercent	integer:int32	False
readPostNames	Array<string>	False
totalCount	integer:int32	False

模型 WalletTransaction

字段	类型	必填	说明
apiVersion	string	True
kind	string	True
metadata	Metadata	True
spec	WalletTransactionSpec	True

模型 WalletTransactionList

字段	类型	必填	说明
first	boolean	True	Indicates whether current page is the first page.
hasNext	boolean	True	Indicates whether current page has next page.
hasPrevious	boolean	True	Indicates whether current page has previous page.
items	Array<WalletTransaction>	True	A chunk of items.
last	boolean	True	Indicates whether current page is the last page.
page	integer:int32	True	Page number, starts from 1. If not set or equal to 0, it means no pagination.
size	integer:int32	True	Size of each page. If not set or equal to 0, it means no pagination.
total	integer:int64	True	Total elements.
totalPages	integer:int64	True	Indicates total pages.

模型 WalletTransactionSpec

字段	类型	必填	说明
amount	number	False	交易金额（余额）
assetType	string	False	资产类型
balanceAfter	number	False	交易后余额
balanceBefore	number	False	交易前余额
cardName	string	False	关联卡密名称
operationKey	string	False	业务幂等键
orderName	string	False	关联订单名称
points	integer:int32	False	交易积分
pointsAfter	integer:int32	False	交易后积分
pointsBefore	integer:int32	False	交易前积分
remark	string	False	备注
reservedBalanceAfter	number	False	交易后冻结余额
reservedBalanceBefore	number	False	交易前冻结余额
transactionAt	string:date-time	False	交易时间
type	string	False	交易类型
username	string	True	用户名

模型 WithdrawApplyRequest

字段	类型	必填	说明
accountInfo	string	False
amount	number	False
remark	string	False
withdrawMethod	string	False

安全与状态处理

区分 401、403、404、409 和网关错误。若响应被重定向到登录页或返回 HTML，不能调用 json() 后当成业务成功。 页面按钮只控制展示，不能代替身份、所有者、金额、功能授权和支付回调验签。 评论凭证是 HttpOnly Cookie；仅输入邮箱的请求不能冒领。公开内容查询不能返回草稿/私密内容。

API 速览 · 支付配置