Files
rootandClaude Opus 4.7 2a42621d8e Remove 买点 (user acquisition tracking) subsystem
Delete the dataReport SDK, event storage model, and scheduled uploader,
along with the reportser/srv_report wrapper services and all ~20 Report*
call sites in business code. Also drop the ReportSDKConfig field from
the APP config response, the TrackerAppId helper, and the related
dataReport yaml config block.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-11-07 11:03:50 +08:00

6195 lines
157 KiB
YAML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
basePath: /
definitions:
authapi.loginReq:
properties:
account:
description: 账号或邮箱
type: string
channel:
description: 渠道码(可选,用户无商区码时写入)
type: string
devID:
description: 设备唯一标示(可选)
type: string
password:
description: 明文密码
type: string
required:
- account
- password
type: object
authapi.registerReq:
properties:
accountNo:
description: 账号
type: string
agentInviteCode:
description: 邀请人的邀请码(可选)
type: string
channel:
description: 渠道码(可选,用户无商区码时写入)
type: string
devID:
description: 设备唯一标示(可选)
type: string
email:
description: 邮箱(可选)
type: string
password:
description: 明文密码
type: string
required:
- accountNo
- password
type: object
authapi.resetPasswordReq:
properties:
accountNo:
description: 账号
type: string
email:
description: 邮箱
type: string
newPassword:
description: 新密码
type: string
required:
- accountNo
- email
- newPassword
type: object
authapi.updateProfileReq:
properties:
avatar:
description: 新头像 URL(可选)
type: string
introduction:
description: 简介(可选)
type: string
newPassword:
description: 新密码明文(设置或修改密码时必填)
type: string
nickName:
description: 新昵称(可选)
type: string
oldPassword:
description: 旧密码明文(已设置密码时修改必填)
type: string
privacyMode:
description: 隐私模式:true-开启,false-关闭(可选)
type: boolean
type: object
authser.GuestLoginReq:
properties:
channel:
description: 渠道码(可选,用户无商区码时写入 DistrictCode)
type: string
devID:
description: 设备唯一标示(必填)
type: string
deviceId:
description: 备用设备ID(可选,写入 DevV2)
type: string
mac:
description: 设备 Mac(可选)
type: string
type: object
authser.LoginResp:
properties:
accountNo:
type: string
avatar:
description: 头像
type: string
currentVipExpire:
description: VIP 过期时间,客户端需结合 vipType 判断是否真正有效
type: string
email:
type: string
hasPassword:
description: 是否已设置密码
type: boolean
introduction:
description: 简介
type: string
inviteCode:
description: 邀请码
type: string
isNewUser:
description: 本次是否新建游客
type: boolean
isRegister:
description: 是否已注册
type: boolean
loginType:
allOf:
- $ref: '#/definitions/pubdef.LoginType'
description: 登陆方式
nickName:
type: string
privacyMode:
description: 隐私模式
type: boolean
recharge:
description: 金币余额
type: integer
score:
description: 积分
type: integer
showCardId:
description: 最新会员卡id
type: integer
showCardName:
description: 最新会员卡名称
type: string
status:
$ref: '#/definitions/pubdef.UserStatus'
token:
type: string
type:
allOf:
- $ref: '#/definitions/pubdef.UserType'
description: 身份类型:0游客 1普通用户
userId:
type: integer
vipType:
$ref: '#/definitions/pubdef.VipType'
type: object
coinapi.buyCoinReq:
properties:
packageId:
description: 购买套餐ID(金币充值)
type: integer
payMode:
description: 支付方式:alipay/wechat
type: string
required:
- packageId
- payMode
type: object
coinser.BuyCoinResp:
properties:
isOpenNewBrowser:
type: boolean
payUrl:
type: string
payUrlMode:
type: string
tradeNo:
type: string
type: object
cointransmod.FlowDir:
enum:
- 1
- -1
type: integer
x-enum-comments:
FlowIn: 收入(充值、赠送)
FlowOut: 支出(消费、解锁)
x-enum-varnames:
- FlowIn
- FlowOut
cointransmod.TranType:
enum:
- 1
- 2
- 3
- 4
- 5
- 6
type: integer
x-enum-comments:
TranTypeAdminAdjust: 管理员手动调整
TranTypeCoinGift: 金币充值赠送
TranTypeCoinRecharge: 金币充值(购买金币)
TranTypeDarkAlley: 历史遗留交易类型(已下线)
TranTypeVideoUnlock: 视频解锁
TranTypeVipGiftCoin: 购买会员赠送金币
x-enum-varnames:
- TranTypeCoinRecharge
- TranTypeVipGiftCoin
- TranTypeDarkAlley
- TranTypeVideoUnlock
- TranTypeAdminAdjust
- TranTypeCoinGift
proto.AdvitiseData:
properties:
AList:
description: 固定12广告位
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
BList:
description: 固定13广告位
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
bottomBanner:
description: 底部banner
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
detailTopList:
description: 详情页顶部广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
detailbannerList:
description: 详情banner
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
dialogList:
description: 弹窗广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
downList:
description: 底部广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
floatingList:
description: 悬浮小方块
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
friendList:
description: 友链
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
homeList:
description: 首页列表
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
launchScreenList:
description: 启动页广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
nineGridList:
description: 9宫格
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
pauseyList:
description: 暂停广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
playList:
description: 播放强制跳转
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
titleList:
description: 标题广告
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
videoInfoList:
description: 视频详情
items:
$ref: '#/definitions/proxy.AdvitiseInfo'
type: array
type: object
proto.AnnouncementItem:
properties:
content:
description: 内容
type: string
id:
description: 公告ID
type: integer
title:
description: 标题
type: string
type: object
proto.AppCategoryInfo:
properties:
appList:
description: 应用列表
items:
$ref: '#/definitions/proto.AppInfoData'
type: array
code:
description: 分类编码(特殊值:12=广告位A 13=广告位B)
type: integer
id:
description: 分类ID
type: integer
intro:
description: 分类简介
type: string
sort:
description: 排序
type: integer
title:
description: 分类标题
type: string
type: object
proto.AppInfoData:
properties:
advitiseId:
description: 广告ID(广告条目时返回)
type: string
categoryId:
description: 所属分类ID
type: integer
description:
description: 详细描述
type: string
id:
description: 应用ID
type: integer
intro:
description: 简介
type: string
location:
description: 广告位置ID
type: integer
logo:
description: Logo 图片地址
type: string
name:
description: 应用名称
type: string
sort:
description: 排序
type: integer
url:
description: 跳转链接(已含渠道码)
type: string
type: object
proto.AppListResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
category:
allOf:
- $ref: '#/definitions/proto.AppCategoryInfo'
description: 当前分类(含应用列表)
categoryList:
description: 应用分类列表(含各分类下的应用列表)
items:
$ref: '#/definitions/proto.AppCategoryInfo'
type: array
config:
allOf:
- $ref: '#/definitions/proto.ConfigInfo'
description: 配置信息
path:
description: 当前路径
type: string
type: object
proto.AppRichTextItemResp:
properties:
content:
description: 内容
type: string
desc:
description: 标题(app)
type: string
id:
description: 富文本ID
type: integer
title:
description: 标题
type: string
type: object
proto.AppRichTextListResp:
properties:
list:
description: 富文本内容列表
items:
$ref: '#/definitions/proto.AppRichTextItemResp'
type: array
type: object
proto.AppTranslationInfo:
properties:
categoryList:
items:
$ref: '#/definitions/proto.TranslationCategory'
type: array
type: object
proto.CoinTransListItemResp:
properties:
amount:
description: 本次交易金币数,始终为正数
type: integer
balanceAfter:
description: 交易后余额
type: integer
balanceBefore:
description: 交易前余额
type: integer
changeAmount:
description: 带方向的金币变动数,收入为正数,支出为负数
type: integer
createdAt:
description: 交易时间,格式:2006-01-02 15:04:05
type: string
flowDir:
allOf:
- $ref: '#/definitions/cointransmod.FlowDir'
description: 收支方向:1-收入,-1-支出
flowDirName:
description: 收支方向名称:收入/支出
type: string
id:
description: 流水ID
type: integer
orderNo:
description: 关联订单号
type: string
relatedId:
description: 关联内容ID
type: integer
remark:
description: 备注
type: string
title:
description: 标题,优先使用备注,备注为空时使用交易类型名称
type: string
tranType:
allOf:
- $ref: '#/definitions/cointransmod.TranType'
description: 交易类型 1-金币充值(购买金币)2-购买会员赠送金币 3-历史遗留 4-视频解锁 5-管理员手动调整
tranTypeName:
description: 交易类型名称
type: string
type: object
proto.CommentInfo:
properties:
children:
description: 二级评论列表
items:
$ref: '#/definitions/proto.CommentInfo'
type: array
commentCount:
description: 二级评论数量
type: integer
countLike:
description: 评论点赞数
type: integer
createdAt:
description: 创建时间
type: string
id:
description: 评论ID
type: integer
isLike:
description: 当前用户点赞状态 1-已点赞 2-未点赞
type: integer
level:
description: 评论级别 1-一级评论 2-二级评论
type: integer
objectId:
description: 对象ID
type: integer
objectType:
description: 对象类型 10-短剧 11-短剧剧集 20-视频
type: integer
parentsId:
description: 父评论ID,一级评论为0
type: integer
replyCommentId:
description: 被回复评论ID,一级评论为0
type: integer
replyUserName:
description: 被回复用户昵称
type: string
text:
description: 评论内容
type: string
userAvatar:
description: 用户头像,已拼接图片域名
type: string
userId:
description: 评论用户ID
type: integer
userName:
description: 用户名称
type: string
type: object
proto.CommentLikeSetReq:
properties:
commentId:
description: 评论ID
type: integer
isLike:
description: 是否点赞,true-点赞,false-取消点赞
type: boolean
required:
- commentId
- isLike
type: object
proto.CommentLikeSetResp:
properties:
commentId:
description: 评论ID
type: integer
countLike:
description: 评论点赞数
type: integer
isLike:
description: 点赞状态 1-已点赞 2-未点赞
type: integer
type: object
proto.CommentSendReq:
properties:
objectId:
description: 对象ID,短剧评论传短剧ID,剧集评论传剧集ID,视频评论传视频ID
type: integer
objectType:
description: 对象类型 10-短剧 11-短剧剧集 20-视频
type: integer
parentsId:
description: 一级评论ID,0-发布一级评论,大于0-发布二级评论
type: integer
replyCommentId:
description: 被回复评论ID,0时默认回复parentsId
type: integer
text:
description: 评论内容
type: string
type: object
proto.CommonData:
properties:
anchor:
description: 作者/演员
type: string
banner:
description: banner图,已拼接图片域名
type: string
categoryIds:
description: 分类ID集合
items:
type: integer
type: array
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
countLike:
description: 点赞数,包含真实点赞数和后台虚拟点赞数
type: integer
cover:
description: 竖版封面,已拼接图片域名
type: string
createdAt:
description: 创建时间
type: string
desc:
description: 简介
type: string
description:
description: SEO Description
type: string
heatValue:
description: 热度值
type: integer
horizontalCover:
description: 横版封面,已拼接图片域名
type: string
id:
description: 短剧id
type: integer
isFeatured:
description: 是否爆剧(true-是,false-否)
type: boolean
isNew:
description: 是否上新,本周内上架为true
type: boolean
isOriginal:
description: 是否原创
type: boolean
isRecommend:
description: 是否推荐 true-推荐,false-不推荐
type: boolean
mediaCreatedAt:
description: 媒资中心创建时间
type: string
mediaUpdatedAt:
description: 媒资中心更新时间
type: string
onlineAt:
description: 上架时间
type: string
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
playName:
description: 剧名
type: string
preview:
description: 预告地址,详情接口返回时带播放签名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
showOnBanner:
description: 是否显示在首页banner
type: boolean
showOriginal:
description: 页面是否展示原创标识
type: boolean
slug:
description: slug
type: string
status:
description: '状态: 0下架 1上架'
type: integer
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
updatedAt:
description: 修改时间
type: string
type: object
proto.ConfigInfo:
properties:
actressBackGround:
description: 女优通用背景图
type: string
advitiesTopicNum:
description: 广告间隔
type: integer
appAddr:
description: APP下载地址(落地页)
type: string
channelCode:
description: 渠道码
type: string
customerServiceHost:
description: 在线客服
type: string
dhDescription:
description: 导航SEO描述
type: string
dhKeyworld:
description: 导航SEO关键字
items:
type: string
type: array
dhNewUrlAddr1:
description: 导航页-线路1
type: string
dhNewUrlAddr2:
description: 导航页-线路2
type: string
dhNewUrlAddr3:
description: 导航页-线路3
type: string
dhSiteName:
description: 导航SEO网站名称
type: string
dhTitle:
description: 导航SEO标题
type: string
enableH265:
description: 是否允许客户端使用 H265 地址播放
type: boolean
foreverUrlAddr:
description: 永久地址
type: string
freeVPN:
description: 免费vpn链接
type: string
gitAddr:
description: git地址
type: string
gmailAddr:
description: 邮箱地址
type: string
imgAppUsCdn:
description: 图片CDN(海外app使用)
type: string
imgCdn:
description: 图片CDN
type: string
mediaAppUsCdn:
description: 视频CDN(海外app使用)
type: string
newUrlAddr:
description: 最新地址
type: string
newUrlAddr1:
description: 最新地址(备用地址1)
type: string
newUrlAddr2:
description: 最新地址(备用地址2)
type: string
officialAppAddr:
description: 官网app地址
type: string
pdfAddr:
description: 回家的路PDF
type: string
potaoGroup:
description: 土豆群
type: string
qq:
description: qq群
type: string
telegram:
description: 商务tg
type: string
telegramAdd:
description: 加入我们tg
type: string
tgGroup:
description: tg群
type: string
translationAddr:
description: 应用导航
type: string
tsCdn:
description: 视频CDN
type: string
twitterAddr:
description: 推特地址
type: string
useIngAddress:
description: 所有使用中的域名
items:
type: string
type: array
watermarkImage:
description: 图片水印文件
type: string
webAddr:
description: 网站SEO网站地址
type: string
webDescription:
description: 网站SEO描述
type: string
webKeyworld:
description: 网站SEO关键字
items:
type: string
type: array
webSiteName:
description: 网站SEO网站名称
type: string
webTitle:
description: 网站SEO标题
type: string
weiChart:
description: 微信群
type: string
type: object
proto.ConfigInfoResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告配置
config:
allOf:
- $ref: '#/definitions/proto.ConfigInfo'
description: 完整系统配置(与首页等接口的 config 一致,含 potaoGroup 等其余字段)
navPageList:
description: 导航页线路集合
items:
$ref: '#/definitions/proto.NavPageItem'
type: array
newAddressInfo:
allOf:
- $ref: '#/definitions/proto.NewAddressInfo'
description: 最新地址信息
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 全站SEO信息
seoNavInfo:
allOf:
- $ref: '#/definitions/proto.SeoNavInfo'
description: 导航SEO信息
type: object
proto.ContactUsAddReq:
properties:
attachments:
description: 附件地址,可存放多张图片或文件地址
items:
type: string
type: array
content:
description: 内容
type: string
email:
description: 邮箱
type: string
title:
description: 标题
type: string
type:
description: 问题类型,1-订单问题、2-账号问题、3-功能问题、4-体验问题、5-其他
type: integer
required:
- content
- email
- title
- type
type: object
proto.ContactUsAddResp:
properties:
message:
description: 提示信息
type: string
type: object
proto.FeedbackReq:
properties:
contact:
description: 联系方式,可为空
type: string
content:
description: 描述内容,最多500字
type: string
screenshots:
description: 问题截图,可存放多张图片地址
items:
type: string
type: array
type:
description: 问题类型,1-功能建议、2-Bug反馈、3-体验问题、4-账号问题、5-其他
type: integer
required:
- content
- type
type: object
proto.FeedbackResp:
properties:
message:
description: 提示信息
type: string
type: object
proto.FooterBrand:
properties:
content:
description: 品牌标语
type: string
title:
description: 品牌标题
type: string
type: object
proto.FooterContact:
properties:
name:
description: 联系方式名称
type: string
value:
description: 联系方式值
type: string
type: object
proto.FooterInfo:
properties:
brand:
allOf:
- $ref: '#/definitions/proto.FooterBrand'
description: 品牌信息
contactList:
description: 联系方式
items:
$ref: '#/definitions/proto.FooterContact'
type: array
navList:
description: 底部导航
items:
$ref: '#/definitions/proto.TranslationCategory'
type: array
type: object
proto.FooterInfoResp:
properties:
footerInfo:
allOf:
- $ref: '#/definitions/proto.FooterInfo'
description: 底部信息
type: object
proto.GetCommentListResp:
properties:
list:
description: 数据
items:
$ref: '#/definitions/proto.CommentInfo'
type: array
objectId:
description: 对象ID
type: integer
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总数量
type: integer
type: object
proto.HomeConfigThemeData:
properties:
icon:
description: 题材图标,已拼接图片域名
type: string
id:
description: 题材ID
type: integer
list:
description: 题材下短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
name:
description: 题材名称
type: string
playletCount:
description: 当前 list 中的短剧数量
type: integer
rank:
description: 排序,越大越靠前
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 题材对应页面SEO信息
slug:
description: 题材slug
type: string
type: object
proto.HomeHtmlData:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
bottonTranslations:
allOf:
- $ref: '#/definitions/proto.AppTranslationInfo'
description: 底部导航
completePath:
description: 请求路径
type: string
config:
allOf:
- $ref: '#/definitions/proto.ConfigInfo'
description: 配置文件
hotSearch:
description: 热搜
items:
$ref: '#/definitions/proto.HotSearchItem'
type: array
path:
type: string
translations:
allOf:
- $ref: '#/definitions/proto.AppTranslationInfo'
description: 导航
type: object
proto.HomeModuleData:
properties:
cardBackgroundImage:
type: string
categoryId:
type: integer
dataType:
description: 固定为 1 短剧
type: integer
desc:
type: string
id:
type: integer
keyword:
description: 页面关键字
items:
type: string
type: array
label:
type: string
limit:
description: 实际生效的首页展示数量
type: integer
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
moduleType:
description: 1 短剧列表,2 题材
type: integer
rank:
type: integer
recommendType:
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: 首页配置表中的SEO信息
slug:
type: string
style:
type: string
title:
type: string
topicList:
items:
$ref: '#/definitions/proto.HomeConfigThemeData'
type: array
type: object
proto.HomePlayletResponse:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
announcements:
description: 启用中的公告,来自独立缓存
items:
$ref: '#/definitions/proto.AnnouncementItem'
type: array
homeBannerData:
description: 首页banner短剧信息列表
items:
$ref: '#/definitions/proto.CommonData'
type: array
modules:
description: 首页短剧和题材模块
items:
$ref: '#/definitions/proto.HomeModuleData'
type: array
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息(短剧列表页SEO)
type: object
proto.HotSearchItem:
properties:
addedTime:
description: 上架shi时间
type: string
desc:
description: 描述
type: string
hotValue:
description: 热度值
type: integer
id:
description: ID
type: integer
images:
description: 封面
type: string
title:
description: 标题
type: string
works:
description: 作品数量
type: integer
type: object
proto.NavPageItem:
properties:
line:
description: 线路序号
type: integer
url:
description: 线路地址
type: string
type: object
proto.NewAddressInfo:
properties:
appAddr:
description: APP下载地址(落地页)
type: string
customerServiceHost:
description: 在线客服
type: string
foreverUrlAddr:
description: 永久海外地址(翻墙访问 永不迷路)
type: string
gmailAddr:
description: 邮箱地址
type: string
newUrlAddr:
description: 新国内地址
type: string
newUrlAddr1:
description: 备用地址1
type: string
newUrlAddr2:
description: 备用地址1
type: string
officialAppAddr:
description: 官网app地址
type: string
pdfAddr:
description: 回家的路PDF
type: string
telegram:
description: 商务tg
type: string
tgGroup:
description: tg群
type: string
twitterAddr:
description: 推特地址
type: string
type: object
proto.PayMethodInfo:
properties:
type:
description: alipay / wechat / union
type: string
typeName:
description: 支付宝 / 微信 / 银联
type: string
type: object
proto.PlayletAllListResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletBoughtData:
properties:
anchor:
description: 作者/演员
type: string
banner:
description: banner图,已拼接图片域名
type: string
boughtAt:
description: 最近购买时间
type: string
boughtChapterCount:
description: 已购剧集数量
type: integer
categoryIds:
description: 分类ID集合
items:
type: integer
type: array
costCoins:
description: 已消耗金币
type: integer
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
countLike:
description: 点赞数,包含真实点赞数和后台虚拟点赞数
type: integer
cover:
description: 竖版封面,已拼接图片域名
type: string
createdAt:
description: 创建时间
type: string
desc:
description: 简介
type: string
description:
description: SEO Description
type: string
heatValue:
description: 热度值
type: integer
horizontalCover:
description: 横版封面,已拼接图片域名
type: string
id:
description: 短剧id
type: integer
isFeatured:
description: 是否爆剧(true-是,false-否)
type: boolean
isFinished:
description: 当前用户是否已看完
type: boolean
isNew:
description: 是否上新,本周内上架为true
type: boolean
isOriginal:
description: 是否原创
type: boolean
isRecommend:
description: 是否推荐 true-推荐,false-不推荐
type: boolean
lastChapterId:
description: 最近观看剧集ID,无观看进度时为0
type: integer
lastEpisode:
description: 最近观看集数,无观看进度时为0
type: integer
mediaCreatedAt:
description: 媒资中心创建时间
type: string
mediaUpdatedAt:
description: 媒资中心更新时间
type: string
onlineAt:
description: 上架时间
type: string
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
playName:
description: 剧名
type: string
preview:
description: 预告地址,详情接口返回时带播放签名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
showOnBanner:
description: 是否显示在首页banner
type: boolean
showOriginal:
description: 页面是否展示原创标识
type: boolean
slug:
description: slug
type: string
status:
description: '状态: 0下架 1上架'
type: integer
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
unwatchedCount:
description: 当前用户未看集数,按totalEpisode-watchedCount计算
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
updatedAt:
description: 修改时间
type: string
watchedCount:
description: 当前用户已看集数
type: integer
type: object
proto.PlayletBoughtListResp:
properties:
list:
description: 已购短剧集合
items:
$ref: '#/definitions/proto.PlayletBoughtData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总已购短剧数量
type: integer
type: object
proto.PlayletChapterCollectData:
properties:
chapterId:
description: 短剧剧集ID
type: integer
chapterTitle:
description: 剧集标题
type: string
collectedAt:
description: 收藏时间
type: string
countBrowse:
description: 剧集观看数
type: integer
countCollect:
description: 剧集收藏数
type: integer
currentEpisode:
description: 第几集
type: integer
isCollect:
description: 收藏状态,收藏列表固定返回1-已收藏
type: integer
mediaTime:
description: 影片长度(秒)
type: integer
payType:
description: 支付方式 0-免费 1-金币 2-VIP
type: integer
playletCover:
description: 短剧封面,已拼接图片域名
type: string
playletId:
description: 短剧ID
type: integer
playletTitle:
description: 短剧标题
type: string
singleCoins:
description: 单集金币
type: integer
totalEpisode:
description: 短剧总集数
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
videoUrl:
description: 播放地址
type: string
type: object
proto.PlayletChapterCollectListResp:
properties:
list:
description: 收藏剧集集合
items:
$ref: '#/definitions/proto.PlayletChapterCollectData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总收藏数量
type: integer
type: object
proto.PlayletChapterCollectSetReq:
properties:
chapterId:
description: 短剧剧集ID
type: integer
isCollect:
description: 是否收藏,true-收藏,false-取消收藏
type: boolean
required:
- chapterId
- isCollect
type: object
proto.PlayletChapterCollectSetResp:
properties:
chapterId:
description: 短剧剧集ID
type: integer
countCollect:
description: 短剧剧集收藏数
type: integer
isCollect:
description: 收藏状态 1-已收藏 2-未收藏
type: integer
type: object
proto.PlayletChapterData:
properties:
balance:
description: 当前金币余额
type: integer
canWatch:
description: 是否可观看
type: boolean
costCoins:
description: 本次解锁消耗金币
type: integer
currentEpisode:
description: 第几集
type: integer
hash:
description: 媒体hash
type: string
height:
description: 高
type: integer
id:
description: 短剧剧集ID
type: integer
isUnlocked:
description: 当前用户是否已解锁本集
type: boolean
md5:
description: 媒体md5
type: string
mediaSize:
description: 资源大小
type: integer
mediaTime:
description: 影片长度(秒)
type: integer
needUnlock:
description: 是否需要金币解锁
type: boolean
needVip:
description: 是否需要开通VIP
type: boolean
payType:
description: 支付方式 0-免费 1-金币 2-VIP
type: integer
playletId:
description: 短剧ID
type: integer
ratio:
description: 宽高比
type: number
singleCoins:
description: 单集金币(支付方式为1-金币时候生效)
type: integer
title:
description: 章节名
type: string
videoUrl:
description: 视频地址
type: string
vipValid:
description: 当前用户VIP是否有效
type: boolean
width:
description: 宽
type: integer
type: object
proto.PlayletChapterInfoResp:
properties:
balance:
description: 当前金币余额
type: integer
canWatch:
description: 是否可观看
type: boolean
costCoins:
description: 本次解锁消耗金币
type: integer
countBrowse:
description: 短剧剧集观看数
type: integer
countCollect:
description: 短剧剧集收藏数
type: integer
countComment:
description: 短剧剧集评论数
type: integer
countLike:
description: 短剧剧集点赞数
type: integer
currentEpisode:
description: 第几集
type: integer
hash:
description: 媒体hash
type: string
height:
description: 高
type: integer
id:
description: 短剧剧集ID
type: integer
isCollect:
description: 收藏状态 1-已收藏 2-未收藏
type: integer
isLike:
description: 点赞状态 1-已点赞 2-未点赞
type: integer
isUnlocked:
description: 当前用户是否已解锁本集
type: boolean
md5:
description: 媒体md5
type: string
mediaSize:
description: 资源大小
type: integer
mediaTime:
description: 影片长度(秒)
type: integer
needUnlock:
description: 是否需要金币解锁
type: boolean
needVip:
description: 是否需要开通VIP
type: boolean
payType:
description: 支付方式 0-免费 1-金币 2-VIP
type: integer
playletId:
description: 短剧ID
type: integer
ratio:
description: 宽高比
type: number
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
singleCoins:
description: 单集金币(支付方式为1-金币时候生效)
type: integer
title:
description: 章节名
type: string
videoUrl:
description: 视频地址
type: string
vipValid:
description: 当前用户VIP是否有效
type: boolean
width:
description: 宽
type: integer
type: object
proto.PlayletChapterLikeSetReq:
properties:
chapterId:
description: 短剧剧集ID
type: integer
isLike:
description: 是否点赞,true-点赞,false-取消点赞
type: boolean
required:
- chapterId
- isLike
type: object
proto.PlayletChapterLikeSetResp:
properties:
chapterId:
description: 短剧剧集ID
type: integer
countLike:
description: 短剧剧集点赞数
type: integer
isLike:
description: 点赞状态 1-已点赞 2-未点赞
type: integer
type: object
proto.PlayletChapterListResp:
properties:
list:
description: 短剧剧集集合
items:
$ref: '#/definitions/proto.PlayletChapterData'
type: array
playletId:
description: 短剧ID
type: integer
type: object
proto.PlayletChapterUnlockReq:
properties:
chapterId:
description: 短剧剧集ID
type: integer
playletId:
description: 短剧ID
type: integer
required:
- chapterId
- playletId
type: object
proto.PlayletChapterUnlockResp:
properties:
balance:
description: 当前金币余额
type: integer
canWatch:
description: 是否可观看
type: boolean
changeCoin:
description: 本次实际扣减金币,幂等命中时为0
type: integer
chapterId:
description: 短剧剧集ID
type: integer
costCoins:
description: 本次解锁消耗金币
type: integer
playletId:
description: 短剧ID
type: integer
unlocked:
description: 是否已解锁
type: boolean
type: object
proto.PlayletChapterWatchReportReq:
properties:
chapterId:
description: 短剧剧集ID
type: integer
playletId:
description: 短剧ID,传入时用于校验剧集归属
type: integer
required:
- chapterId
type: object
proto.PlayletChapterWatchReportResp:
properties:
chapterId:
description: 短剧剧集ID
type: integer
currentEpisode:
description: 当前集数
type: integer
lastChapterId:
description: 最近观看剧集ID
type: integer
lastEpisode:
description: 最近观看集数
type: integer
playletId:
description: 短剧ID
type: integer
unwatchedCount:
description: 当前用户未看集数
type: integer
watchedCount:
description: 当前用户已看集数
type: integer
type: object
proto.PlayletCollectData:
properties:
collectedAt:
description: 收藏时间
type: string
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
cover:
description: 封面,已拼接图片域名
type: string
heatValue:
description: 热度值
type: integer
id:
description: 短剧ID
type: integer
isCollect:
description: 收藏状态,收藏列表固定返回1-已收藏
type: integer
lastChapterId:
description: 最近观看剧集ID,无观看进度时为0
type: integer
lastEpisode:
description: 最近观看集数,无观看进度时为0
type: integer
playName:
description: 剧名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
slug:
description: slug
type: string
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
unwatchedCount:
description: 当前用户未看集数,按totalEpisode-watchedCount计算
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
watchedCount:
description: 当前用户已看集数
type: integer
type: object
proto.PlayletCollectListResp:
properties:
list:
description: 收藏短剧集合
items:
$ref: '#/definitions/proto.PlayletCollectData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总收藏数量
type: integer
type: object
proto.PlayletCollectSetReq:
properties:
id:
description: 短剧ID
type: integer
isCollect:
description: 是否收藏,true-收藏,false-取消收藏
type: boolean
required:
- id
- isCollect
type: object
proto.PlayletCollectSetResp:
properties:
countCollect:
description: 短剧收藏数
type: integer
id:
description: 短剧ID
type: integer
isCollect:
description: 收藏状态 1-已收藏 2-未收藏
type: integer
type: object
proto.PlayletForwardHeatReq:
properties:
id:
description: 短剧ID
type: integer
required:
- id
type: object
proto.PlayletForwardHeatResp:
properties:
heatValue:
description: 加热后的热度值
type: integer
id:
description: 短剧ID
type: integer
type: object
proto.PlayletGuessLikeListResp:
properties:
list:
description: 猜你喜欢短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletHistoryClearResp:
properties:
deletedCount:
description: 删除记录数量
type: integer
type: object
proto.PlayletHistoryData:
properties:
anchor:
description: 作者/演员
type: string
banner:
description: banner图,已拼接图片域名
type: string
categoryIds:
description: 分类ID集合
items:
type: integer
type: array
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
countLike:
description: 点赞数,包含真实点赞数和后台虚拟点赞数
type: integer
cover:
description: 竖版封面,已拼接图片域名
type: string
createdAt:
description: 创建时间
type: string
desc:
description: 简介
type: string
description:
description: SEO Description
type: string
heatValue:
description: 热度值
type: integer
historyAt:
description: 最近观看时间
type: string
horizontalCover:
description: 横版封面,已拼接图片域名
type: string
id:
description: 短剧id
type: integer
isFeatured:
description: 是否爆剧(true-是,false-否)
type: boolean
isFinished:
description: 是否已看完
type: boolean
isNew:
description: 是否上新,本周内上架为true
type: boolean
isOriginal:
description: 是否原创
type: boolean
isRecommend:
description: 是否推荐 true-推荐,false-不推荐
type: boolean
lastChapterId:
description: 最近观看剧集ID
type: integer
lastEpisode:
description: 最近观看集数
type: integer
mediaCreatedAt:
description: 媒资中心创建时间
type: string
mediaUpdatedAt:
description: 媒资中心更新时间
type: string
onlineAt:
description: 上架时间
type: string
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
playName:
description: 剧名
type: string
preview:
description: 预告地址,详情接口返回时带播放签名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
showOnBanner:
description: 是否显示在首页banner
type: boolean
showOriginal:
description: 页面是否展示原创标识
type: boolean
slug:
description: slug
type: string
status:
description: '状态: 0下架 1上架'
type: integer
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
unwatchedCount:
description: 当前用户未看集数
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
updatedAt:
description: 修改时间
type: string
watchedCount:
description: 当前用户已看集数
type: integer
type: object
proto.PlayletHistoryDeleteReq:
properties:
playletId:
description: 短剧ID
type: integer
required:
- playletId
type: object
proto.PlayletHistoryDeleteResp:
properties:
deletedCount:
description: 删除记录数量
type: integer
type: object
proto.PlayletHistoryListResp:
properties:
list:
description: 观看历史集合
items:
$ref: '#/definitions/proto.PlayletHistoryData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总历史数量
type: integer
type: object
proto.PlayletHomeConfigListResp:
properties:
advitise:
$ref: '#/definitions/proto.AdvitiseData'
config:
$ref: '#/definitions/proto.HomeModuleData'
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
type: integer
pageSize:
type: integer
topicList:
items:
$ref: '#/definitions/proto.HomeConfigThemeData'
type: array
totalCount:
type: integer
type: object
proto.PlayletHotLikeResp:
properties:
guessLike:
description: 按收藏量最多的15部上架短剧
items:
$ref: '#/definitions/proto.CommonData'
type: array
hotSearch:
description: 前10个热搜词
items:
$ref: '#/definitions/proto.PlayletHotSearchItem'
type: array
type: object
proto.PlayletHotListResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletHotRankListResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
rankType:
description: 榜单类型 1-热播榜 2-新剧榜 3-追剧榜
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletHotSearchItem:
properties:
count:
description: 搜索次数
type: integer
keyword:
description: 搜索词
type: string
type: object
proto.PlayletInfoResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
anchor:
description: 作者/演员
type: string
banner:
description: banner图,已拼接图片域名
type: string
categoryIds:
description: 分类ID集合
items:
type: integer
type: array
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
countLike:
description: 点赞数,包含真实点赞数和后台虚拟点赞数
type: integer
cover:
description: 竖版封面,已拼接图片域名
type: string
createdAt:
description: 创建时间
type: string
desc:
description: 简介
type: string
description:
description: SEO Description
type: string
heatValue:
description: 热度值
type: integer
horizontalCover:
description: 横版封面,已拼接图片域名
type: string
id:
description: 短剧id
type: integer
isCollect:
description: 是否收藏(1-已收藏,2-未收藏)
type: integer
isFeatured:
description: 是否爆剧(true-是,false-否)
type: boolean
isLike:
description: 是否点赞(1-已点赞,2-未点赞)
type: integer
isNew:
description: 是否上新,本周内上架为true
type: boolean
isOriginal:
description: 是否原创
type: boolean
isRecommend:
description: 是否推荐 true-推荐,false-不推荐
type: boolean
mediaCreatedAt:
description: 媒资中心创建时间
type: string
mediaUpdatedAt:
description: 媒资中心更新时间
type: string
onlineAt:
description: 上架时间
type: string
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
playName:
description: 剧名
type: string
playletChapterInfo:
description: 短剧章节集合
items:
$ref: '#/definitions/proto.PlayletChapterData'
type: array
preview:
description: 预告地址,详情接口返回时带播放签名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
showOnBanner:
description: 是否显示在首页banner
type: boolean
showOriginal:
description: 页面是否展示原创标识
type: boolean
slug:
description: slug
type: string
status:
description: '状态: 0下架 1上架'
type: integer
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
updatedAt:
description: 修改时间
type: string
type: object
proto.PlayletLikeData:
properties:
anchor:
description: 作者/演员
type: string
banner:
description: banner图,已拼接图片域名
type: string
categoryIds:
description: 分类ID集合
items:
type: integer
type: array
countBrowse:
description: 观看量
type: integer
countCollect:
description: 收藏数
type: integer
countLike:
description: 点赞数,包含真实点赞数和后台虚拟点赞数
type: integer
cover:
description: 竖版封面,已拼接图片域名
type: string
createdAt:
description: 创建时间
type: string
desc:
description: 简介
type: string
description:
description: SEO Description
type: string
heatValue:
description: 热度值
type: integer
horizontalCover:
description: 横版封面,已拼接图片域名
type: string
id:
description: 短剧id
type: integer
isFeatured:
description: 是否爆剧(true-是,false-否)
type: boolean
isLike:
description: 固定为1-已点赞
type: integer
isNew:
description: 是否上新,本周内上架为true
type: boolean
isOriginal:
description: 是否原创
type: boolean
isRecommend:
description: 是否推荐 true-推荐,false-不推荐
type: boolean
likedAt:
description: 点赞时间
type: string
mediaCreatedAt:
description: 媒资中心创建时间
type: string
mediaUpdatedAt:
description: 媒资中心更新时间
type: string
onlineAt:
description: 上架时间
type: string
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
playName:
description: 剧名
type: string
preview:
description: 预告地址,详情接口返回时带播放签名
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
showOnBanner:
description: 是否显示在首页banner
type: boolean
showOriginal:
description: 页面是否展示原创标识
type: boolean
slug:
description: slug
type: string
status:
description: '状态: 0下架 1上架'
type: integer
tagIds:
description: 标签ID集合
items:
type: integer
type: array
tagNames:
description: 标签名称集合
items:
type: string
type: array
tagSlugs:
description: 标签slug集合
items:
type: string
type: array
themeIds:
description: 题材ID集合
items:
type: integer
type: array
themeNames:
description: 题材名称集合
items:
type: string
type: array
themeSlugs:
description: 题材slug集合
items:
type: string
type: array
title:
description: 标题
type: string
totalEpisode:
description: 总集数
type: integer
updateStatus:
description: 更新状态 1-连载中 2-已完结
type: integer
updatedAt:
description: 修改时间
type: string
type: object
proto.PlayletLikeListResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.PlayletLikeData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 已点赞且上架的短剧总数
type: integer
type: object
proto.PlayletLikeSetReq:
properties:
id:
description: 短剧ID
type: integer
isLike:
description: 是否点赞,true-点赞,false-取消点赞
type: boolean
required:
- id
- isLike
type: object
proto.PlayletLikeSetResp:
properties:
countLike:
description: 短剧点赞数
type: integer
id:
description: 短剧ID
type: integer
isLike:
description: 点赞状态 1-已点赞 2-未点赞
type: integer
type: object
proto.PlayletOperateListResp:
properties:
filterType:
description: 筛选类型 1-最近更新 2-当前热播 3-独家原创
type: integer
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
operateType:
description: 运营类型 1-短剧 2-漫剧
type: integer
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletRankResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息(短剧列表页SEO)
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletSearchResp:
properties:
everyoneWatching:
description: 大家都在看,搜索无结果时返回
items:
$ref: '#/definitions/proto.CommonData'
type: array
keyword:
description: 搜索词
type: string
list:
description: 搜索结果
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletSearchSuggestResp:
properties:
keyword:
description: 搜索关键词
type: string
list:
description: 短剧列表
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
proto.PlayletTagItem:
properties:
id:
description: 标签ID
type: integer
name:
description: 标签名称
type: string
rank:
description: 排序,越大越靠前
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 标签对应页面 SEO 信息
slug:
description: slug
type: string
status:
description: 上架状态
type: boolean
type: object
proto.PlayletTagListResponse:
properties:
list:
description: 标签列表
items:
$ref: '#/definitions/proto.PlayletTagItem'
type: array
type: object
proto.PlayletTagVideoResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息(标签SEO)
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletThemeItem:
properties:
icon:
description: 题材图标,已拼接图片域名
type: string
id:
description: 题材ID
type: integer
isRecommend:
description: 是否推荐
type: boolean
name:
description: 题材名称
type: string
playletCount:
description: 该题材绑定的上架短剧数量
type: integer
rank:
description: 排序,越大越靠前
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 题材对应页面 SEO 信息
slug:
description: slug
type: string
status:
description: 上架状态
type: boolean
type: object
proto.PlayletThemeListResponse:
properties:
list:
description: 题材列表
items:
$ref: '#/definitions/proto.PlayletThemeItem'
type: array
type: object
proto.PlayletTodayUpdateResp:
properties:
list:
description: 短剧集合
items:
$ref: '#/definitions/proto.CommonData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息(短剧列表页SEO)
totalCount:
description: 总共数量
type: integer
type: object
proto.PlayletTopicDetailResp:
properties:
advitise:
$ref: '#/definitions/proto.AdvitiseData'
covers:
description: 顶部封面集合
items:
type: string
type: array
dataType:
type: integer
desc:
description: 描述
type: string
icon:
description: 图标
type: string
id:
description: 专题ID
type: integer
list:
description: 专题短剧列表
items:
$ref: '#/definitions/proto.CommonData'
type: array
moreTopics:
description: 更多专题
items:
$ref: '#/definitions/proto.PlayletTopicPageItem'
type: array
name:
description: 专题名称
type: string
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
playletCount:
description: 当前页 list 中的短剧数量
type: integer
rank:
description: 排序,越大越靠前
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 专题SEO
slug:
description: slug
type: string
totalCount:
description: 短剧总数
type: integer
type: object
proto.PlayletTopicGroupPageItem:
properties:
desc:
description: 专题区块描述
type: string
id:
description: 专题区块ID
type: integer
list:
description: 当前页专题
items:
$ref: '#/definitions/proto.PlayletTopicPageItem'
type: array
name:
description: 专题区块名称
type: string
rank:
description: 区块排序,越大越靠前
type: integer
totalCount:
description: 区块下专题总数
type: integer
type: object
proto.PlayletTopicPageItem:
properties:
covers:
description: 专题列表为一张短剧封面
items:
type: string
type: array
desc:
description: 描述
type: string
icon:
description: 图标
type: string
id:
description: 专题ID
type: integer
list:
description: 专题列表为一部短剧
items:
$ref: '#/definitions/proto.CommonData'
type: array
name:
description: 专题名称
type: string
playletCount:
description: 当前 list 中的短剧数量
type: integer
rank:
description: 排序,越大越靠前
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 专题SEO
slug:
description: slug
type: string
type: object
proto.PlayletTopicPageListResp:
properties:
list:
description: 专题区块集合
items:
$ref: '#/definitions/proto.PlayletTopicGroupPageItem'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
type: object
proto.RechargePackageItem:
properties:
baseCoin:
description: 基础金币数
type: integer
durationDays:
description: 会员有效天数
type: integer
durationHours:
description: 会员有效小时数,由durationDays计算
type: integer
giftCoin:
description: 赠送金币数
type: integer
id:
description: 套餐ID
type: integer
name:
description: 展示标题
type: string
originalPrice:
description: 原价,单位分
type: integer
packageType:
allOf:
- $ref: '#/definitions/rechargepackagemod.PackageType'
description: 套餐类型:1-会员畅享 2-金币充值
payMethods:
description: 该套餐支持的支付方式
items:
$ref: '#/definitions/proto.PayMethodInfo'
type: array
price:
description: 售价,单位分
type: integer
sort:
description: 排序,越小越靠前
type: integer
subTitle:
description: 展示副标题
type: string
totalCoin:
description: 到账总金币数,由baseCoin+giftCoin计算
type: integer
type: object
proto.RechargePackageListResp:
properties:
coinList:
description: 金币充值列表
items:
$ref: '#/definitions/proto.RechargePackageItem'
type: array
vipList:
description: 会员畅享列表
items:
$ref: '#/definitions/proto.RechargePackageItem'
type: array
type: object
proto.SeoInfo:
properties:
canonicalUrl:
description: 当前内容的标准URL
type: string
description:
description: 页面描述
type: string
keywords:
description: 页面关键词
items:
type: string
type: array
title:
description: 页面标题
type: string
webSiteName:
description: 网站名称
type: string
type: object
proto.SeoNavInfo:
properties:
dhDescription:
description: 导航描述
type: string
dhKeyworld:
description: 关键词
items:
type: string
type: array
dhSiteName:
description: 导航名称
type: string
dhTitle:
description: 导航标题
type: string
type: object
proto.TranslationCategory:
properties:
categoryType:
allOf:
- $ref: '#/definitions/pubdef.TranslationType'
description: 导航类型
icon:
description: Icon
type: string
id:
type: integer
name:
description: 名称
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
translationList:
items:
$ref: '#/definitions/proto.TranslationInfo'
type: array
urlValue:
description: URl路径
type: string
type: object
proto.TranslationInfo:
properties:
id:
description: ID
type: integer
isFriendAds:
description: 是否是友链广告位
type: boolean
name:
description: 名称
type: string
urlValue:
description: URl路径
type: string
type: object
proto.UserCenterDataResp:
properties:
boughtChapterCount:
description: 已购剧集数量
type: integer
chasingCount:
description: 追剧中数量
type: integer
collectCount:
description: 收藏数量
type: integer
watchCount:
description: 观看数量
type: integer
type: object
proto.VideoAllListItemResp:
properties:
addedTime:
description: 上架时间
type: string
coverImg:
description: 封面
type: string
creatorId:
description: 作者Id
type: integer
creatorName:
description: 作者名称
type: string
id:
description: id
type: integer
keyworld:
description: 关键字
items:
type: string
type: array
mediaType:
description: 类型 1-影集 2-动画
type: integer
slug:
description: slug
type: string
tags:
description: 标签
items:
type: integer
type: array
title:
description: 标题
type: string
topicIds:
description: 题材ID集合
items:
type: integer
type: array
topicNames:
description: 题材名称集合
items:
type: string
type: array
topics:
description: 题材集合
items:
$ref: '#/definitions/proto.VideoTopicInfo'
type: array
videoCount:
description: 视频数量
type: integer
videoTime:
description: 影片长度
type: integer
watchTimes:
description: 观看数
type: integer
type: object
proto.VideoAllListResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
list:
description: 视频集合
items:
$ref: '#/definitions/proto.VideoAllListItemResp'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
totalCount:
description: 总共数量
type: integer
type: object
proto.VideoCollectData:
properties:
collectedAt:
description: 收藏时间
type: string
countCollect:
description: 收藏数
type: integer
countComment:
description: 评论数
type: integer
countLike:
description: 点赞数
type: integer
coverImg:
description: 封面
type: string
id:
description: 视频ID
type: integer
isCollect:
description: 收藏状态,收藏列表固定返回1-已收藏
type: integer
keyworld:
description: 关键字
items:
type: string
type: array
slug:
description: slug
type: string
tags:
description: 标签
items:
type: integer
type: array
title:
description: 标题
type: string
videoTime:
description: 影片长度
type: integer
watchTimes:
description: 观看数
type: integer
type: object
proto.VideoCollectListResp:
properties:
list:
description: 收藏视频集合
items:
$ref: '#/definitions/proto.VideoCollectData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总收藏数量
type: integer
type: object
proto.VideoCollectSetReq:
properties:
id:
description: 视频ID
type: integer
isCollect:
description: 是否收藏,true-收藏,false-取消收藏
type: boolean
required:
- id
- isCollect
type: object
proto.VideoCollectSetResp:
properties:
countCollect:
description: 视频收藏数
type: integer
id:
description: 视频ID
type: integer
isCollect:
description: 收藏状态 1-已收藏 2-未收藏
type: integer
type: object
proto.VideoData:
properties:
cover:
description: 视频封面
type: string
fileId:
description: 媒资库ID
type: string
height:
description: 分辨率高(视频才会存在)
type: integer
preMp4FileNameFs:
description: 预览MP4文件
type: string
taskId:
description: 视频ID(视频才会存在)
type: string
unencryptedPreMp4:
description: 不加密的预览MP4
type: string
url:
description: 视频URl
type: string
videoTime:
description: 影片长度
type: integer
width:
description: 分辨率宽(视频才会存在)
type: integer
type: object
proto.VideoHistoryClearResp:
properties:
deletedCount:
description: 删除记录数量
type: integer
type: object
proto.VideoHistoryData:
properties:
countCollect:
description: 收藏数
type: integer
countComment:
description: 评论数
type: integer
countLike:
description: 点赞数
type: integer
coverImg:
description: 封面
type: string
historyAt:
description: 最近观看时间
type: string
id:
description: 视频ID
type: integer
isCollect:
description: 收藏状态 1-已收藏 2-未收藏
type: integer
keyworld:
description: 关键字
items:
type: string
type: array
slug:
description: slug
type: string
tags:
description: 标签
items:
type: integer
type: array
title:
description: 标题
type: string
videoTime:
description: 影片长度
type: integer
watchTimes:
description: 观看数
type: integer
type: object
proto.VideoHistoryDeleteReq:
properties:
videoId:
description: 视频ID
type: integer
required:
- videoId
type: object
proto.VideoHistoryDeleteResp:
properties:
deletedCount:
description: 删除记录数量
type: integer
type: object
proto.VideoHistoryListResp:
properties:
list:
description: 观看历史集合
items:
$ref: '#/definitions/proto.VideoHistoryData'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总历史数量
type: integer
type: object
proto.VideoInfoResp:
properties:
advitise:
allOf:
- $ref: '#/definitions/proto.AdvitiseData'
description: 广告
countCollect:
description: 收藏数
type: integer
countComment:
description: 评论数
type: integer
countLike:
description: 点赞数
type: integer
coverImg:
description: 封面
type: string
id:
description: id
type: integer
isCollect:
description: 当前用户收藏状态 1-已收藏 2-未收藏
type: integer
isLike:
description: 当前用户点赞状态 1-已点赞 2-未点赞
type: integer
keyworld:
description: 关键字
items:
type: string
type: array
seoInfo:
allOf:
- $ref: '#/definitions/proto.SeoInfo'
description: 页面SEO信息
slug:
description: slug
type: string
tags:
description: 标签
items:
type: integer
type: array
tagsName:
description: 标签名称
items:
type: string
type: array
title:
description: 标题
type: string
topicIds:
description: 题材ID集合
items:
type: integer
type: array
topics:
description: 题材集合
items:
$ref: '#/definitions/proto.VideoTopicInfo'
type: array
video:
allOf:
- $ref: '#/definitions/proto.VideoData'
description: 视频
watchTimes:
description: 观看数(真假之和)
type: integer
type: object
proto.VideoItemResp:
properties:
addedTime:
description: 上架时间
type: string
coverImg:
description: 封面
type: string
creatorId:
description: 作者Id
type: integer
creatorName:
description: 作者名称
type: string
id:
description: id
type: integer
keyworld:
description: 关键字
items:
type: string
type: array
slug:
description: slug
type: string
tags:
description: 标签
items:
type: integer
type: array
title:
description: 标题
type: string
videoTime:
description: 影片长度
type: integer
watchTimes:
description: 观看数(真假之和)
type: integer
type: object
proto.VideoLikeSetReq:
properties:
id:
description: 视频ID
type: integer
isLike:
description: 是否点赞,true-点赞,false-取消点赞
type: boolean
required:
- id
- isLike
type: object
proto.VideoLikeSetResp:
properties:
countLike:
description: 视频点赞数
type: integer
id:
description: 视频ID
type: integer
isLike:
description: 点赞状态 1-已点赞 2-未点赞
type: integer
type: object
proto.VideoResp:
properties:
list:
description: 视频列表
items:
$ref: '#/definitions/proto.VideoItemResp'
type: array
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
proto.VideoTopicInfo:
properties:
desc:
description: 描述
type: string
id:
description: Id
type: integer
image:
description: 背景
type: string
name:
description: 专题名称
type: string
seoInfo:
allOf:
- $ref: '#/definitions/pubdef.SeoValue'
description: Seo相关信息
slug:
description: slug
type: string
title:
description: APP显示
type: string
videoCategoryId:
description: 视频分类id
type: integer
works:
description: 作品数
type: integer
type: object
proto.VideoTopicListResp:
properties:
list:
description: 题材集合
items:
$ref: '#/definitions/proto.VideoTopicInfo'
type: array
type: object
proxy.AdvitiseInfo:
properties:
id:
description: 广告id
type: string
images:
description: 视频banner
type: string
link:
description: 链接
type: string
location:
description: 位置id
type: integer
title:
description: 广告标题
type: string
type: object
pubdef.LoginType:
enum:
- 0
- 1
- 2
type: integer
x-enum-comments:
LoginTypeAccount: 账号登陆
LoginTypeDevice: 设备登陆
LoginTypeEmail: 邮箱登陆
x-enum-varnames:
- LoginTypeDevice
- LoginTypeAccount
- LoginTypeEmail
pubdef.SeoValue:
properties:
description:
description: 网站SEO描述
type: string
keyworld:
description: 网站SEO关键字
items:
type: string
type: array
title:
description: 网站SEO标题
type: string
type: object
pubdef.TranslationType:
enum:
- 1
- 2
- 3
type: integer
x-enum-comments:
TranslationTypeBottom: 底部导航
TranslationTypeSub: 二级导航
TranslationTypeUrl: URL模式
x-enum-varnames:
- TranslationTypeUrl
- TranslationTypeSub
- TranslationTypeBottom
pubdef.UserStatus:
enum:
- 0
- 1
- 2
type: integer
x-enum-comments:
UserStatusDisable: 封禁
UserStatusNormal: 正常
UserStatusSlient: 禁言
x-enum-varnames:
- UserStatusNormal
- UserStatusDisable
- UserStatusSlient
pubdef.UserType:
enum:
- 0
- 1
- 0
type: integer
x-enum-comments:
UserTypeGuest: 游客用户
UserTypeNormal: 普通用户(已注册)
x-enum-varnames:
- UserTypeGuest
- UserTypeNormal
- UserTypeNone
pubdef.VipOrderStatus:
enum:
- 1
- 2
- 3
type: integer
x-enum-comments:
VipOrderFailed: 支付失败
VipOrderPending: 待支付
VipOrderSuccess: 支付成功
x-enum-varnames:
- VipOrderPending
- VipOrderSuccess
- VipOrderFailed
pubdef.VipType:
enum:
- 0
- 1
- 2
type: integer
x-enum-comments:
VipTypeMonth: 月卡
VipTypeNone: 没卡
VipTypeYear: 年卡
x-enum-varnames:
- VipTypeNone
- VipTypeMonth
- VipTypeYear
rechargeapi.submitOrderReq:
properties:
packageId:
description: 购买套餐ID(会员畅享)
type: integer
payMode:
description: 支付方式:alipay/wechat
type: string
required:
- packageId
- payMode
type: object
rechargepackagemod.PackageType:
enum:
- 1
- 2
type: integer
x-enum-comments:
PackageTypeCoin: 金币充值
PackageTypeVip: 会员畅享
x-enum-varnames:
- PackageTypeVip
- PackageTypeCoin
rechargeser.SubmitOrderResp:
properties:
isOpenNewBrowser:
description: 是否需要外部浏览器打开
type: boolean
payUrl:
description: 支付链接
type: string
payUrlMode:
description: 链接打开方式
type: string
tradeNo:
description: 本地订单号(可用于查询)
type: string
type: object
response.BasePageResp:
properties:
list:
description: 集合列表
pageNum:
description: 页数
type: integer
pageSize:
description: 每页数
type: integer
totalCount:
description: 总共数量
type: integer
type: object
statcenter.AiSellMsg:
properties:
amount:
type: integer
appID:
type: integer
currencyType:
type: string
devType:
type: string
isRepurchase:
type: string
sysType:
type: string
tranCreatedAt:
type: string
tranType:
type: string
uid:
type: integer
uniqID:
type: string
type: object
statcenter.BuyVIPType:
enum:
- 0
- 1
type: integer
x-enum-comments:
BuyVIPTypeGold: 金币
BuyVIPTypeMoney: 现金
x-enum-varnames:
- BuyVIPTypeMoney
- BuyVIPTypeGold
statcenter.CardSellMsg:
properties:
amount:
type: integer
appID:
type: integer
currencyType:
description: 0金币 1现金
type: integer
product:
$ref: '#/definitions/statcenter.Product'
sysType:
type: string
tranCreatedAt:
type: string
tranType:
type: string
tranTypeInt:
type: integer
uid:
type: integer
uniqID:
type: string
type: object
statcenter.ConsumeRecordMsg:
properties:
amount:
description: 金币
type: number
appID:
type: integer
createdAt:
type: string
currencyType:
description: 0金币 1人民币
type: integer
money:
description: 人民币 元
type: number
type:
description: 消费类型
type: integer
uid:
type: integer
uniq:
type: string
type: object
statcenter.Product:
properties:
discountedPrice:
type: integer
id:
type: string
name:
type: string
type: object
statcenter.StatcenterSyncReq:
properties:
job:
description: 同步任务类型
type: string
maxSize:
description: 最大条数
type: integer
platformId:
description: 原始平台Id(访问/流水)
type: string
successTime:
description: 游标时间(购买会员、提现、充值)
type: string
userId:
description: 用户(注册)
type: integer
type: object
statcenter.StatcenterSyncResp:
properties:
accessList:
description: 日活记录
items:
$ref: '#/definitions/statcenter.UserVisitMsg'
type: array
aiSellList:
description: AI销售流水
items:
$ref: '#/definitions/statcenter.AiSellMsg'
type: array
allRechargeList:
description: 全部支付订单
items:
$ref: '#/definitions/statcenter.UserRechargeMsg'
type: array
bindingList:
description: 用户绑定记录
items:
$ref: '#/definitions/statcenter.UserBindingMsg'
type: array
buyVipList:
description: VIP购买记录
items:
$ref: '#/definitions/statcenter.UserBuyVIPMsg'
type: array
cardSellList:
description: 会员卡销售流水
items:
$ref: '#/definitions/statcenter.CardSellMsg'
type: array
code:
description: 200正常 其他异常
type: integer
consumeList:
description: 消费流水
items:
$ref: '#/definitions/statcenter.ConsumeRecordMsg'
type: array
inviteList:
description: 邀请绑定
items:
$ref: '#/definitions/statcenter.UserInviteBindMsg'
type: array
job:
description: 类型
type: string
msg:
description: 错误消息
type: string
rechargeList:
description: 充值记录
items:
$ref: '#/definitions/statcenter.UserRechargeMsg'
type: array
registerList:
description: 注册记录
items:
$ref: '#/definitions/statcenter.UserRegisterMsg'
type: array
visitList:
description: 日活记录(旧字段,兼容)
items:
$ref: '#/definitions/statcenter.UserVisitMsg'
type: array
type: object
statcenter.UserBindingMsg:
properties:
appId:
description: appID
type: integer
bindingTime:
description: 绑定时间
type: string
devType:
description: 设备类型
type: string
mobile:
description: 手机号/绑定账号(本项目填邮箱)
type: string
platformId:
description: 原始平台流水Id
type: string
sysType:
description: 操作系统类型
type: string
userId:
description: 用户ID
type: integer
type: object
statcenter.UserBuyVIPMsg:
properties:
amount:
type: integer
appId:
type: integer
buyVIPType:
$ref: '#/definitions/statcenter.BuyVIPType'
deviceType:
type: string
districtCode:
type: string
isDirect:
type: boolean
money:
type: integer
name:
type: string
oid:
type: string
platformId:
type: string
promCode:
type: string
status:
type: integer
successTime:
type: string
uid:
type: integer
type: object
statcenter.UserInviteBindMsg:
properties:
appId:
type: integer
inviteTime:
type: string
parentPromCode:
type: string
userId:
type: integer
required:
- appId
- inviteTime
- userId
type: object
statcenter.UserRechargeMsg:
properties:
appId:
type: integer
chanShareMod:
type: integer
channelName:
type: string
cid:
type: string
createdAt:
type: string
devType:
type: string
districtCode:
type: string
isNewOrOldUser:
type: boolean
money:
type: integer
oid:
type: string
orderId:
type: string
payMoney:
type: integer
paymentAt:
type: string
platformId:
type: string
productType:
type: integer
rate:
type: string
registerTime:
type: string
status:
type: integer
successAt:
type: string
sysType:
type: string
type:
type: string
userId:
type: integer
required:
- appId
- money
- orderId
- payMoney
- sysType
- userId
type: object
statcenter.UserRegisterMsg:
properties:
appId:
description: appID
type: integer
devType:
description: 设备类型
type: string
districtCode:
description: 渠道码
type: string
ip:
description: IP
type: string
isDirect:
description: true:是直推用户
type: boolean
mobile:
description: 手机号
type: string
name:
description: 名称
type: string
platformId:
description: 原始平台流水Id
type: string
promCode:
description: 推广序列
type: string
promSeqe:
description: 全名代理
type: string
puc:
description: 应用中心推广
type: string
registerTime:
description: 注册时间
type: string
sysType:
description: 操作系统类型 安卓 IOS
type: string
userId:
description: 用户ID
type: integer
required:
- appId
- isDirect
- registerTime
- sysType
- userId
type: object
statcenter.UserVisitMsg:
properties:
appId:
description: appID
type: integer
devID:
description: 设备ID
type: string
devType:
description: 设备型号
type: string
districtCode:
description: 渠道码
type: string
ip:
description: IP
type: string
isDirect:
description: true:是直推用户
type: boolean
platformId:
description: 原始平台流水Id
type: string
registerTime:
description: 用户注册时间
type: string
sysType:
description: 操作系统类型 安卓 IOS
type: string
userId:
description: 用户ID
type: integer
version:
description: APP版本号
type: string
visitAt:
description: 访问时间
type: string
type: object
uploadser.ImageUploadData:
properties:
id:
type: string
sourceNameFs:
type: string
type: object
uploadser.ImageUploadResp:
properties:
code:
type: integer
data:
$ref: '#/definitions/uploadser.ImageUploadData'
hash:
type: boolean
msg:
type: string
time:
type: string
tip:
type: string
type: object
vipordermod.OrderType:
enum:
- 1
- 2
type: integer
x-enum-comments:
OrderTypeCoin: 金币购买
OrderTypeVip: 会员购买
x-enum-varnames:
- OrderTypeVip
- OrderTypeCoin
vipordermod.VipOrder:
properties:
amount:
description: 支付金额(分)
type: integer
baseCoin:
description: 基础金币数(快照)
type: integer
cardId:
description: ── VIP 专用 ──
type: integer
cardName:
description: 套餐名快照
type: string
coin:
description: 到账金币数(快照)
type: integer
coinCfgId:
description: ── 金币专用 ──
type: integer
createdAt:
description: 创建时间
type: string
districtCode:
description: 下单时用户渠道码
type: string
finishedAt:
description: 完成时间
type: string
giftCoin:
description: 赠送金币数(快照)
type: integer
id:
description: 唯一ID
type: integer
ipAddr:
description: 客户端 IP
type: string
oid:
description: 第三方订单号
type: string
orderType:
allOf:
- $ref: '#/definitions/vipordermod.OrderType'
description: 订单类型:1会员 2金币
payChannel:
description: 支付渠道
type: string
payMode:
description: 支付方式:overage/alipay/wechat
type: string
payRate:
description: 费率
type: string
payUrl:
description: 支付链接
type: string
payUrlMode:
description: 链接打开方式
type: string
status:
allOf:
- $ref: '#/definitions/pubdef.VipOrderStatus'
description: 订单状态
sysType:
description: ios/android
type: string
tradeNo:
description: 本地订单号
type: string
updatedAt:
description: 更新时间
type: string
userId:
description: 用户ID
type: integer
type: object
host: https://视频站-api.lcncctn.com
info:
contact: {}
description: 这是视频站APP接口服务.
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
title: 视频站APP接口
version: "1.0"
paths:
/api/app/applist/list:
get:
consumes:
- application/json
description: 返回应用分类列表,每个分类下含应用信息列表;categoryId=0 返回第一个分类
parameters:
- description: 当前分类ID,0表示默认第一个分类
in: query
name: categoryId
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.AppListResp'
"400":
description: 失败
schema:
type: string
summary: 查询应用列表
tags:
- 应用列表
/api/app/auth/getInfo:
get:
description: 通过 token 获取最新用户信息,包含金币余额、VIP状态等
produces:
- application/json
responses:
"200":
description: 用户信息
schema:
$ref: '#/definitions/authser.LoginResp'
"400":
description: 失败
schema:
type: string
summary: 获取当前用户信息
tags:
- 用户认证
/api/app/auth/guest:
post:
consumes:
- application/json
description: 按设备ID创建或找回游客账号;请求头可带 Authorization 复用已有游客会话。需传 X-User-Agent
parameters:
- description: 游客登录参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/authser.GuestLoginReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/authser.LoginResp'
"400":
description: 失败
schema:
type: string
summary: 游客登录
tags:
- 用户认证
/api/app/auth/login:
post:
consumes:
- application/json
description: 账号或邮箱均可作为登录凭证
parameters:
- description: 登录参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/authapi.loginReq'
produces:
- application/json
responses:
"200":
description: 登录成功,返回 token 及用户基本信息
schema:
$ref: '#/definitions/authser.LoginResp'
"400":
description: 失败
schema:
type: string
summary: 登录
tags:
- 用户认证
/api/app/auth/profile:
post:
consumes:
- application/json
description: 用户信息通过 token 获取,无需传账号;nickName、avatar、introduction、oldPassword+newPassword
均为可选,至少提供一项。未设置密码时传 newPassword 可设置密码,已设置密码时修改需传 oldPassword+newPassword
parameters:
- description: 修改资料参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/authapi.updateProfileReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
type: string
"400":
description: 失败
schema:
type: string
summary: 修改用户资料(头像 / 简介 / 密码,可任意组合)
tags:
- 用户认证
/api/app/auth/register:
post:
consumes:
- application/json
description: 传入账号和明文密码,邮箱可选,请求头带游客 Authorization 时升级该游客为普通用户,否则新建用户
parameters:
- description: 注册参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/authapi.registerReq'
produces:
- application/json
responses:
"200":
description: 注册成功,返回 token 及用户基本信息
schema:
$ref: '#/definitions/authser.LoginResp'
"400":
description: 失败
schema:
type: string
summary: 注册
tags:
- 用户认证
/api/app/auth/resetPassword:
post:
consumes:
- application/json
description: 通过账号和邮箱双重校验后重置密码,两者必须同时匹配同一用户
parameters:
- description: 找回密码参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/authapi.resetPasswordReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
type: string
"400":
description: 失败
schema:
type: string
summary: 找回密码
tags:
- 用户认证
/api/app/coin/buy:
post:
consumes:
- application/json
description: 根据指定金币套餐发起第三方支付,返回支付链接
parameters:
- description: 购买参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/coinapi.buyCoinReq'
produces:
- application/json
responses:
"200":
description: 支付链接
schema:
$ref: '#/definitions/coinser.BuyCoinResp'
security:
- ApiKeyAuth: []
summary: 购买金币
tags:
- 金币
/api/app/coin/orders:
get:
parameters:
- description: 页码(默认1)
in: query
name: page
type: integer
- description: 每页数量(默认10)
in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 订单列表
schema:
type: object
security:
- ApiKeyAuth: []
summary: 查询金币购买记录
tags:
- 金币
/api/app/coin/trans/export:
get:
description: 导出当前登录用户的金币收入、支出流水CSV;type=0全部 1充值 2消费 3奖励
parameters:
- description: 类型:0全部 1充值 2消费 3奖励
in: query
name: type
type: integer
produces:
- text/csv
responses:
"200":
description: CSV文件
schema:
type: file
security:
- ApiKeyAuth: []
summary: 导出金币余额明细 -- by 王鸣
tags:
- 金币
/api/app/coin/trans/list:
get:
description: 返回当前登录用户的金币收入、支出流水,按交易时间倒序;type=0全部 1充值 2消费 3奖励
parameters:
- description: 页码(默认1)
in: query
name: page
type: integer
- description: 每页数量(默认10,最大100)
in: query
name: pageSize
type: integer
- description: 类型:0全部 1充值 2消费 3奖励
in: query
name: type
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/response.BasePageResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CoinTransListItemResp'
type: array
type: object
security:
- ApiKeyAuth: []
summary: 查询金币余额明细 -- by 旺鸣
tags:
- 金币
/api/app/comment/like/set:
post:
consumes:
- application/json
description: 设置当前用户对短剧、短剧剧集或视频评论的点赞状态
parameters:
- description: 评论点赞设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.CommentLikeSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.CommentLikeSetResp'
"400":
description: 获取失败的返回结果
schema:
type: string
security:
- ApiKeyAuth: []
summary: 评论点赞/取消点赞 --by 王鸣
tags:
- 评论APP
/api/app/comment/list:
get:
consumes:
- application/json
description: 分页查询短剧、短剧剧集或视频评论树,一级评论分页返回,二级评论挂在children中,objectType 10-短剧 11-短剧剧集
20-视频
parameters:
- description: 对象ID(短剧id 短剧剧集id 视频id)
in: query
name: objectId
required: true
type: integer
- description: 对象类型 10-短剧 11-短剧剧集 20-视频
in: query
name: objectType
required: true
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-热门,按点赞数倒序 2-最新,按创建时间倒序
in: query
name: sortOrder
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.GetCommentListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommentInfo'
type: array
type: object
"400":
description: 获取失败的返回结果
schema:
type: string
summary: 评论列表 --by 王鸣
tags:
- 评论APP
/api/app/comment/send:
post:
consumes:
- application/json
description: 发布短剧、短剧剧集或视频评论,parentsId为0发布一级评论,大于0发布二级评论,replyCommentId表示实际回复的评论,objectType
10-短剧 11-短剧剧集 20-视频
parameters:
- description: 参数列表
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.CommentSendReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
type: string
"400":
description: 获取失败的返回结果
schema:
type: string
security:
- ApiKeyAuth: []
summary: 发布评论 --by 王鸣
tags:
- 评论APP
/api/app/config/footer/info:
get:
consumes:
- application/json
description: 返回APP底部信息
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.FooterInfoResp'
"400":
description: 失败
schema:
type: string
summary: 查询APP底部信息 --by 王鸣
tags:
- APP配置相关接口
/api/app/config/info:
get:
consumes:
- application/json
description: 返回最新地址信息、完整系统配置、广告配置和全站SEO配置
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.ConfigInfoResp'
"400":
description: 失败
schema:
type: string
summary: 查询APP公共配置 --by 王鸣
tags:
- APP配置相关接口
/api/app/config/richtext/list:
get:
consumes:
- application/json
description: 返回启用状态的富文本内容,支持按ids或titles过滤
parameters:
- description: 富文本ID,多个用英文逗号分隔
in: query
name: ids
type: string
- description: 富文本标题,多个用英文逗号分隔
in: query
name: titles
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.AppRichTextListResp'
"400":
description: 失败
schema:
type: string
summary: 查询APP富文本内容列表 --by 王鸣
tags:
- APP配置相关接口
/api/app/contactus/add:
post:
consumes:
- application/json
description: 用户提交联系我们表单,问题类型:1-订单问题、2-账号问题、3-功能问题、4-体验问题、5-其他
parameters:
- description: 联系我们请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.ContactUsAddReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.ContactUsAddResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: 提交联系我们 -- by 旺鸣
tags:
- 联系我们相关接口
/api/app/feedback/add:
post:
consumes:
- application/json
description: 用户提交意见反馈,问题类型,1-功能建议、2-播放问题、3-账号问题、4-其他
parameters:
- description: 意见反馈请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.FeedbackReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.FeedbackResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: 提交意见反馈 -- by 旺鸣
tags:
- 意见反馈相关接口
/api/app/navigation/header:
get:
consumes:
- application/json
description: 查询导航类型为URL模式和二级导航的头部导航配置
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.AppTranslationInfo'
"400":
description: 失败
schema:
type: string
summary: 查询头部导航配置 -- by 王鸣
tags:
- app导航相关接口
/api/app/playlet/all/list:
get:
consumes:
- application/json
description: 分页查询已上架短剧,支持题材、更新状态和排序筛选
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-最新 2-最热 3-收藏最多
in: query
name: sortType
type: integer
- description: 题材ID
in: query
name: themeId
type: integer
- description: 题材slug,非空时优先按slug解析题材ID
in: query
name: themeSlug
type: string
- description: 更新状态 0-全部 1-连载中 2-已完结
in: query
name: updateStatus
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletAllListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询全部短剧 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/bought/list:
get:
consumes:
- application/json
description: 按当前用户最近购买时间倒序分页返回已购短剧列表,并返回已购集数、消耗金币和最近观看位置
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletBoughtListResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端我的已购短剧列表 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/collect/list:
get:
consumes:
- application/json
description: 按当前用户收藏时间倒序分页返回短剧剧集收藏列表
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterCollectListResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端我的短剧剧集收藏列表 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/collect/set:
post:
consumes:
- application/json
description: 设置当前用户短剧剧集收藏状态,收藏数只在状态真实变化时增减
parameters:
- description: 短剧剧集收藏设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletChapterCollectSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterCollectSetResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端短剧剧集收藏/取消收藏 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/detail:
get:
description: 根据短剧剧集ID查询播放页当前剧集详情;可传playletId或playletSlug校验剧集归属,slug非空时优先解析短剧ID
parameters:
- description: 短剧剧集ID
in: query
name: chapterId
required: true
type: integer
- description: 短剧ID,传入时用于校验剧集归属
in: query
name: playletId
type: integer
- description: 短剧slug,非空时优先按slug解析短剧ID
in: query
name: playletSlug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterInfoResp'
"400":
description: 失败
schema:
type: string
summary: app端根据ID查询短剧剧集详情 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/like/set:
post:
consumes:
- application/json
description: 设置当前用户短剧剧集点赞状态,点赞数只在状态真实变化时增减
parameters:
- description: 短剧剧集点赞设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletChapterLikeSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterLikeSetResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端短剧剧集点赞/取消点赞 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/list:
get:
description: 根据短剧ID或slug查询右侧选集列表;slug非空时优先按slug解析短剧ID
parameters:
- description: 短剧ID
in: query
name: playletId
type: integer
- description: 短剧slug,非空时优先按slug解析短剧ID
in: query
name: playletSlug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterListResp'
"400":
description: 失败
schema:
type: string
summary: app端根据短剧ID查询剧集列表 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/unlock:
post:
consumes:
- application/json
description: 仅金币付费剧集可调用;接口具备幂等性,已解锁剧集重复调用不会重复扣金币
parameters:
- description: 短剧剧集金币解锁请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletChapterUnlockReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterUnlockResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端使用金币逐集解锁短剧剧集 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/chapter/watch/report:
post:
consumes:
- application/json
description: 上报当前用户短剧剧集播放进度,达到已看条件时用于我的收藏未看集数计算
parameters:
- description: 短剧剧集观看上报请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletChapterWatchReportReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletChapterWatchReportResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端短剧剧集观看上报 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/collect/list:
get:
consumes:
- application/json
description: 按当前用户收藏时间倒序分页返回短剧收藏列表,并返回已看/未看集数和最近观看位置;watchStatus=0全部 1追剧中 2已看完
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 观看状态 0-全部 1-追剧中 2-已看完
in: query
name: watchStatus
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletCollectListResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端我的短剧收藏列表 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/collect/set:
post:
consumes:
- application/json
description: 设置当前用户短剧收藏状态,收藏数只在状态真实变化时增减
parameters:
- description: 短剧收藏设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletCollectSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletCollectSetResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端短剧收藏/取消收藏 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/detail:
get:
description: 根据短剧ID或slug查询已上架短剧详情;slug非空时优先按slug解析短剧ID
parameters:
- description: 短剧id
in: query
name: id
type: integer
- description: 短剧slug,非空时优先按slug解析短剧ID
in: query
name: slug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletInfoResp'
"400":
description: 失败
schema:
type: string
summary: app端根据ID查询短剧详情 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/forward/heat:
post:
consumes:
- application/json
description: 请求一次短剧热度值增加5,仅支持已上架短剧
parameters:
- description: 短剧转发加热度请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletForwardHeatReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletForwardHeatResp'
"400":
description: 失败
schema:
type: string
summary: app端短剧转发增加热度 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/guess-like/list:
get:
consumes:
- application/json
description: 根据当前短剧同题材查询猜你喜欢,排除当前短剧
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 当前短剧ID
in: query
name: playletId
required: true
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletGuessLikeListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询猜你喜欢短剧 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/history/clear:
post:
consumes:
- application/json
description: 仅清空观看历史,不影响收藏列表和观看进度
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletHistoryClearResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端清空我的短剧观看历史 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/history/delete:
post:
consumes:
- application/json
description: 删除当前用户指定短剧的观看历史,不影响观看进度、收藏和已购记录
parameters:
- description: 删除单条观看历史请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletHistoryDeleteReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletHistoryDeleteResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端删除单条短剧观看历史 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/history/list:
get:
consumes:
- application/json
description: 按当前用户最近观看时间倒序分页返回短剧观看历史;pageSize默认20、最大100
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletHistoryListResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端我的短剧观看历史列表 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/home:
get:
consumes:
- application/json
description: 无请求参数,返回首页banner短剧、短剧与题材模块、公告和SEO信息
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.HomePlayletResponse'
"400":
description: 失败
schema:
type: string
summary: app端首页短剧接口 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/home-config/list:
get:
consumes:
- application/json
description: 根据首页配置ID或slug分页查询短剧或题材模块内容
parameters:
- in: query
name: id
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- in: query
name: slug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletHomeConfigListResp'
"400":
description: 失败
schema:
type: string
summary: app端查询首页配置内容
tags:
- app短剧相关接口
/api/app/playlet/hot-like:
get:
consumes:
- application/json
description: 返回缓存的前10个热搜词,以及按收藏量最多的15部猜你喜欢短剧
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletHotLikeResp'
"400":
description: 失败
schema:
type: string
summary: app端热搜词和猜你喜欢
tags:
- app短剧相关接口
/api/app/playlet/hot/list:
get:
consumes:
- application/json
description: 按热度查询已上架短剧,可排除指定短剧
parameters:
- description: 排除的短剧ID,默认不排除
in: query
name: excludePlayletId
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletHotListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询热门短剧
tags:
- app短剧相关接口
/api/app/playlet/hot/rank/list:
get:
consumes:
- application/json
description: 分页查询已上架短剧热榜;rankType=1热播榜 2新剧榜 3追剧榜
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 榜单类型 1-热播榜 2-新剧榜 3-追剧榜
in: query
name: rankType
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletHotRankListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询热榜 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/like/list:
get:
consumes:
- application/json
description: 按当前用户点赞时间倒序分页返回已上架短剧
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletLikeListResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端我的短剧点赞列表
tags:
- app短剧相关接口
/api/app/playlet/like/set:
post:
consumes:
- application/json
description: 设置当前用户短剧点赞状态,点赞数只在状态真实变化时增减
parameters:
- description: 短剧点赞设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.PlayletLikeSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletLikeSetResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app端短剧点赞/取消点赞 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/operate/list:
get:
consumes:
- application/json
description: 按运营类型查询已上架短剧;operateType=1短剧 2漫剧;filterType=1最近更新(按上架时间) 2当前热播(按收藏数)
3独家原创(原创且按推荐排序)
parameters:
- description: 筛选类型 1-最近更新 2-当前热播 3-独家原创
in: query
name: filterType
type: integer
- description: 运营类型 1-短剧 2-漫剧
in: query
name: operateType
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletOperateListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端按运营类型分页查询短剧
tags:
- app短剧相关接口
/api/app/playlet/rank:
get:
consumes:
- application/json
description: 分页查询已上架短剧排行榜;sortOrder=1按热度值倒序,2按上架时间倒序,3按收藏数倒序
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-热播榜,按热度值倒序 2-新剧榜,按上架时间倒序 3-追剧榜,按收藏数倒序
in: query
name: sortOrder
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletRankResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: 短剧排行榜 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/search:
get:
consumes:
- application/json
description: 使用ES分页搜索已上架短剧,支持剧名、题材名、简介和标签名检索
parameters:
- description: 搜索关键词,支持剧名、题材名、简介和标签名
in: query
name: keyword
type: string
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletSearchResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端ES分页搜索短剧 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/search/suggest:
get:
consumes:
- application/json
description: 搜索框下拉联想,返回短剧列表
parameters:
- description: 搜索关键词
in: query
name: keyword
required: true
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletSearchSuggestResp'
"400":
description: 失败
schema:
type: string
summary: app端短剧搜索联想 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/tag/list:
get:
consumes:
- application/json
description: 根据标签ID或标签slug分页查询已上架短剧;slug非空时优先按slug解析标签ID;sortType=1最新 2最热 3收藏最多
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-最新 2-最热 3-收藏最多
in: query
name: sortType
type: integer
- description: 标签ID,tagSlug为空时必传
in: query
name: tagId
type: integer
- description: 标签slug,非空时优先按slug解析标签ID
in: query
name: tagSlug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletTagVideoResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端根据标签ID分页查询短剧 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/tag/options:
get:
consumes:
- application/json
description: 无请求参数,不分页,返回已上架短剧标签列表
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletTagListResponse'
"400":
description: 失败
schema:
type: string
summary: app端短剧标签列表 --by 王鸣
tags:
- app短剧标签相关接口
/api/app/playlet/today-update:
get:
consumes:
- application/json
description: 分页查询已上架短剧
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletTodayUpdateResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询今日更新短剧 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/topic/detail:
get:
consumes:
- application/json
description: 按专题ID查询专题信息和专题短剧列表
parameters:
- description: 仅支持 1 短剧
in: query
name: dataType
type: integer
- description: 专题ID
in: query
name: id
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-编辑排序 2-最新 3-最热
in: query
name: sortType
type: integer
- in: query
name: topicSlug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletTopicDetailResp'
- properties:
list:
items:
$ref: '#/definitions/proto.CommonData'
type: array
moreTopics:
items:
$ref: '#/definitions/proto.PlayletTopicPageItem'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端查询专题详情 --by 王鸣
tags:
- app短剧相关接口
/api/app/playlet/topic/list:
get:
consumes:
- application/json
description: 分页查询各启用区块下有已上架短剧的专题卡片
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.PlayletTopicPageListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.PlayletTopicGroupPageItem'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询专题剧单 --by 王鸣
tags:
- app短剧相关接口
/api/app/recharge/package/list:
get:
description: 返回会员畅享和金币充值两个列表,并附带各套餐可用支付方式
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.RechargePackageListResp'
summary: 查询购买套餐列表 -- by 王鸣
tags:
- 金币与会员
/api/app/statcenter/sync:
post:
consumes:
- application/json
description: 按 job 拉取注册/日活/充值/绑定/消费/售卡等增量数据
parameters:
- description: 参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/statcenter.StatcenterSyncReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/statcenter.StatcenterSyncResp'
"400":
description: 失败
schema:
type: string
summary: 统计中心增量同步
tags:
- 数据同步
/api/app/theme/list:
get:
consumes:
- application/json
description: 无请求参数,不分页,返回已上架题材列表
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.PlayletThemeListResponse'
"400":
description: 失败
schema:
type: string
summary: app端短剧题材列表 --by 王鸣
tags:
- app短剧题材相关接口
/api/app/translation/category/list:
get:
consumes:
- application/json
description: 无请求参数,不分页,返回启用的顶部导航分类
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.AppTranslationInfo'
"400":
description: 失败
schema:
type: string
summary: app端导航分类列表 --by 王鸣
tags:
- APP导航相关接口
/api/app/upload/image:
post:
consumes:
- multipart/form-data
description: 将图片转发至存储服务 /media/web/autopublish/image
parameters:
- description: 图片文件
in: formData
name: file
required: true
type: file
- description: 是否加水印:1加,其他情况不加(头像不加)
in: formData
name: watermark
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/uploadser.ImageUploadResp'
"400":
description: 参数错误
schema:
type: string
summary: 图片上传
tags:
- 上传
/api/app/user/center/data:
get:
consumes:
- application/json
description: 返回当前用户观看、收藏、追剧中、已购剧集统计
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.UserCenterDataResp'
"400":
description: 失败
schema:
type: string
security:
- ApiKeyAuth: []
summary: app个人中心数据 --by 王鸣
tags:
- app个人中心相关接口
/api/app/video/all/list:
get:
consumes:
- application/json
description: 分页查询已上架视频,支持类型、题材和排序筛选
parameters:
- description: 类型 0-全部 1-影集 2-动画
in: query
name: mediaType
type: integer
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
- description: 排序 1-最新 2-最热 3-收藏最多
in: query
name: sortType
type: integer
- description: 题材ID,对应video_topic
in: query
name: topicId
type: integer
- description: 题材slug,非空时优先按slug解析题材ID
in: query
name: topicSlug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.VideoAllListResp'
- properties:
list:
items:
$ref: '#/definitions/proto.VideoAllListItemResp'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: app端分页查询视频列表 --by 王鸣
tags:
- 视频相关接口
/api/app/video/collect/list:
get:
consumes:
- application/json
description: 按当前用户收藏时间倒序分页返回视频收藏列表
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoCollectListResp'
"400":
description: 失败
schema:
type: string
summary: app端我的视频收藏列表 --by 王鸣
tags:
- 视频相关接口
/api/app/video/collect/set:
post:
consumes:
- application/json
description: 设置当前用户视频收藏状态,收藏数只在状态真实变化时增减
parameters:
- description: 视频收藏设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.VideoCollectSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoCollectSetResp'
"400":
description: 失败
schema:
type: string
summary: app端视频收藏/取消收藏 --by 王鸣
tags:
- 视频相关接口
/api/app/video/detail:
get:
consumes:
- application/json
description: 查询已上架视频详情
parameters:
- description: 视频id
in: query
name: id
type: integer
- description: 视频slug,非空时优先按slug解析视频ID
in: query
name: slug
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoInfoResp'
"400":
description: 失败
schema:
type: string
summary: 查询视频详情 --by 旺鸣
tags:
- 视频相关接口
/api/app/video/history/clear:
post:
consumes:
- application/json
description: 清空当前用户全部视频观看历史,不影响收藏和点赞
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoHistoryClearResp'
"400":
description: 失败
schema:
type: string
summary: app端清空我的视频观看历史 --by 王鸣
tags:
- 视频相关接口
/api/app/video/history/delete:
post:
consumes:
- application/json
description: 删除当前用户指定视频观看历史,不影响收藏和点赞
parameters:
- description: 删除单条视频观看历史请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.VideoHistoryDeleteReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoHistoryDeleteResp'
"400":
description: 失败
schema:
type: string
summary: app端删除单条视频观看历史 --by 王鸣
tags:
- 视频相关接口
/api/app/video/history/list:
get:
consumes:
- application/json
description: 按当前用户最近观看时间倒序分页返回视频观看历史
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoHistoryListResp'
"400":
description: 失败
schema:
type: string
summary: app端我的视频观看历史列表 --by 王鸣
tags:
- 视频相关接口
/api/app/video/like/set:
post:
consumes:
- application/json
description: 设置当前用户视频点赞状态,点赞数只在状态真实变化时增减
parameters:
- description: 视频点赞设置请求
in: body
name: param
required: true
schema:
$ref: '#/definitions/proto.VideoLikeSetReq'
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoLikeSetResp'
"400":
description: 失败
schema:
type: string
summary: app端视频点赞/取消点赞 --by 王鸣
tags:
- 视频相关接口
/api/app/video/list:
get:
consumes:
- application/json
description: 按上架时间倒序普通分页查询已上架视频
parameters:
- in: query
name: pageNum
type: integer
- in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
allOf:
- $ref: '#/definitions/proto.VideoResp'
- properties:
list:
items:
$ref: '#/definitions/proto.VideoItemResp'
type: array
type: object
"400":
description: 失败
schema:
type: string
summary: 普通分页查询视频 --by 旺鸣
tags:
- 视频相关接口
/api/app/video/topic/list:
get:
consumes:
- application/json
description: 查询已上架视频题材列表,mediaType=0全部 1影集 2动画
parameters:
- description: 类型 0-全部 1-影集 2-动画
in: query
name: mediaType
type: integer
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.VideoTopicListResp'
"400":
description: 失败
schema:
type: string
summary: app端查询视频题材列表 --by 王鸣
tags:
- 视频相关接口
/api/app/vip/orders:
get:
consumes:
- application/json
parameters:
- description: 页码(默认1)
in: query
name: page
type: integer
- description: 每页数量(默认10)
in: query
name: pageSize
type: integer
produces:
- application/json
responses:
"200":
description: 订单列表
schema:
items:
$ref: '#/definitions/vipordermod.VipOrder'
type: array
security:
- ApiKeyAuth: []
summary: 查询 VIP 充值记录
tags:
- 充值
/api/app/vip/pay:
post:
consumes:
- application/json
parameters:
- description: 下单参数
in: body
name: param
required: true
schema:
$ref: '#/definitions/rechargeapi.submitOrderReq'
produces:
- application/json
responses:
"200":
description: 支付链接
schema:
$ref: '#/definitions/rechargeser.SubmitOrderResp'
security:
- ApiKeyAuth: []
summary: 创建 VIP 充值订单(第三方支付)
tags:
- 充值
/richtext/:id:
get:
consumes:
- application/json
description: 标签搜索
parameters:
- description: 参数列表
in: body
name: param
required: true
schema:
type: string
produces:
- application/json
responses:
"200":
description: 成功
schema:
$ref: '#/definitions/proto.HomeHtmlData'
"400":
description: 获取失败的返回结果
schema:
type: string
security:
- ApiKeyAuth: []
summary: 标签搜索
tags:
- 标签搜索
schemes:
- http
- https
securityDefinitions:
ApiKeyAuth:
in: header
name: Authorization
type: apiKey
BasicAuth:
type: basic
OAuth2AccessCode:
authorizationUrl: https://example.com/oauth/authorize
flow: accessCode
scopes:
admin: Grants read and write access to administrative information
tokenUrl: https://example.com/oauth/token
type: oauth2
OAuth2Application:
flow: application
scopes:
admin: Grants read and write access to administrative information
write: Grants write access
tokenUrl: https://example.com/oauth/token
type: oauth2
OAuth2Implicit:
authorizationUrl: https://example.com/oauth/authorize
flow: implicit
scopes:
admin: Grants read and write access to administrative information
write: Grants write access
type: oauth2
OAuth2Password:
flow: password
scopes:
admin: Grants read and write access to administrative information
read: Grants read access
write: Grants write access
tokenUrl: https://example.com/oauth/token
type: oauth2
swagger: "2.0"