RaptDramaDump/docs/接口清单.md

RaptDrama 接口清单

基址使用 https://apis.raptdrama.com。https://app.raptdrama.com 上部分路径也能通，脚本以 apis 为准。

本文只记录已经实际调用过的返回结构。安装包里还有一批路径，返回格式没有核对，放在最后一节，不要把它们当成已确认的协议。

通用约定

业务响应外面都有同一层包装。HTTP 状态经常仍是 200，成功与否看 code。

{
  "code": 200,
  "msg": "ok",
  "data": {}
}

已见到的业务码：

code	含义
200	成功。msg 可能是 ok、成功 或 Login success
299	未登录，msg 为 Please login first。用 Authorization: Bearer 调播放接口时会出现
500	参数错误，例如 Invalid email format、Password cannot be empty、Error Type

请求头：

头	值
Content-Type	application/json。播放和登录都用 JSON，不要用表单
Accept	application/json
User-Agent	RaptDrama/1.1.81 (Android 12; 23113RKC6C; Redmi)
apasstk	登录后拿到的 token。游客 autologin 本身不带这个头
x-app-build	139
x-app-version	1.1.81
x-device-type	phone
x-device-brand	Redmi
x-device-model	23113RKC6C
x-device-id	设备号，例如 rd_ 开头的字符串
x-device-fingerprint	设备指纹
x-device-physical	true
x-os-name	Android
x-os-version	12
accept-language	en-US
accept-language-custom	en-US

登录凭证只放在 apasstk。不要再使用 Authorization: Bearer。

登录

POST /app/open/autologin

每次调用都新建一个游客，不会沿用上一次的账号。不需要 apasstk。

请求体：{}

data：

字段	类型	说明
id	string	新游客 id
nickname	string	随机昵称
token	string	后续请求的 apasstk
score	int
vipday	int
badge	string	例如 BRONZE
watched	int
rewards	int
avatarNum	int
avatarNumUrl	string	头像地址

POST /app/open/emailLogin

同一邮箱重复登录返回同一个用户。不需要先带 apasstk。

请求体：

{"email": "邮箱", "password": "密码"}

email 或 password 用错字段名时，code 为 500。

data：

字段	类型
id	int
nickname	string
email	string
email_bind	int
score	int
tgid	int
isguanzhu	int
sxid	int
os	string
channel	string
token	string
google_bind	int

/auth/login 在这个基址上没有返回上述 JSON 包装，邮箱登录以 /app/open/emailLogin 为准。

POST /app/user/getUserInfo

需要 apasstk。游客 token 也可以调用。

请求体：{}

data：

字段	类型
id	int
nickname	string
email_bind	int
mobile_bind	int
score	int
tgid	int
isguanzhu	int
sxid	int
os	string
channel	string
google_bind	int
apple_bind	int
login_day	int
vipday	int
badge	string
watched	int
rewards	int
avatarNum	int
avatarNumUrl	string

这里的 id 是数字。autologin 返回的 id 是字符串。

分类和剧列表

剧对象在多个接口里重复出现，下面称它为剧目：

字段	类型	说明
id	int	剧 id，播放接口的 vid 用这个值
title	string
update_time	int	Unix 时间
view	int
image	string	封面
tstype	string	分类 id，Passion 为 "20"
desc	string
forstaus	string
forstausen	string	连载状态文案，例如完结
author	string
classify	string[]	题材标签
score	string	评分，是字符串

POST /app/open/classifyv2

请求体：{}

data 是分类数组：

字段	类型	说明
id	int	传给分类视频接口的 type
label	string	英文名
label_origin	string
image	string 或 null

已见到的分类：18 Comedy，20 Passion，21 Newest，22 Western，23 Comic drama。首页顶栏就是这五个标签，脚本用 sections 记成 comedy、passion、newest、western、comic。

首页区块对应

发现页上能对上接口的区块：

界面	接口	脚本里的 sections
顶栏 Comedy / Passion / Newest / Western / Comic drama	POST /app/open/classify_video，type 分别为 18 / 20 / 21 / 22 / 23	comedy / passion / newest / western / comic
New Releases	GET /app/open/orgin	new_releases
Recommend	POST /app/open/recommend，按 page 翻页	recommend

同一部剧可以同时出现在多个区块。脚本按剧 id 合并，播放地址只请求一次，sections 列出它出现过的区块，例如 ["passion","new_releases","recommend"]。

Trending Now 对不上单独的短列表。安装包里发现页有 trendingDramas 和 _buildTrendingSection，但没有单独的拉取方法或 /app/open/ 路径。核对过的结果：

• POST /app/open/extra_broadcast 是历史页里的 extra broadcast，不是发现页的 Trending Now。当前 9 部里没有截图上的 Bai Jie: A Young Wife、Desire Manor、The Love Curse。改 type 或 ishot 仍是这 9 部。
• GET /app/open/orgin 只有 Bai Jie: A Young Wife，没有另外两部。
• Recommend 全量里三部都在，但分散在第 4、7、11 页，不是这一行的短列表。
• 三部的 videoinfo.ishot 都是 0。猜的 /app/open/banner、/hot、/ranking 返回 404。
• /app/open/foryou 不作为首页来源，脚本不调用。

POST /app/open/classify_video

按分类分页。type 才是分类 id。传 tstype、classify 或 id 会返回 code 500、Error Type。

请求体：

{"page": 1, "limit": 10, "type": 20}

page 从 1 开始。每页 10 条，空页表示结束。limit 增大也不会一次返回超过 10 条。

data 是剧目数组。

POST /app/open/recommend

首页 Recommend。page 从 1 开始，limit 用 10。start 会被忽略，不能用来翻页。空对象 {} 和带 page/limit 的第一页一样，大约 10 条，不是全站列表。

请求体：

{"page": 1, "limit": 10}

每页 10 条，相邻页的剧 id 不同。某一页条数不足 10 时还要继续请求下一页。只有空页，或这一页的 id 全部在前面出现过，才停止。脚本最多翻 80 页，避免死循环。

2026-09-26 用游客 token 翻页：第 1–33 页各 10 条，第 34 页 2 条，第 35 页为空。去重后 332 部。

data 是剧目数组。

POST /app/open/foryou

请求体：{}

data 是剧目数组，并多一个 firstchapter：

字段	类型	说明
firstchapter.id	int	集 id
firstchapter.title	string
firstchapter.idx	int	集序号
firstchapter.playurl	string	这一集的播放地址

POST /app/open/extra_broadcast

请求体：{}

data 是剧目数组。这是历史页的列表，不是首页 Trending Now。不传分页参数时返回固定的一小批剧；带 page 也不会换成 Trending Now 那一排。

GET /app/open/orgin

无请求体。POST 空对象同样返回这一批。data 是剧目数组。

这是首页 New Releases。当前一次返回 10 部，按较新的剧排在前面。截图里能看到的 Reaping What She Sowed、The Fall of a Mountain Flower、The Delivery Guy's Rise 是这 10 部的最后三部。加上 type=trending，或 page/limit，仍然只有 10 条，不是另一份 Trending Now 列表。

POST /app/open/search

请求体：

{"keyword": "love", "page": 1, "limit": 10}

data 是剧目数组，并多一个 totalvideo（int，集数）。

POST /app/open/bank

请求体：{}

data 不是剧目数组，而是观看或片库记录：

字段	类型
id	int
vid	int
cid	int
create_time	int
video.id	int
video.title	string
video.image	string
video.desc	string
video.forstaus	string
video.author	string
video.forstausen	string

剧集和播放地址

GET /app/video/getchapters

查询参数：

参数	说明
vid	剧 id
start	起始偏移，从 0 开始
limit	每页条数，可用 200

示例：/app/video/getchapters?vid=1942&start=0&limit=200

data：

字段	类型	说明
count	int	总集数
list[].id	int	集 id，对应播放列表里的 cid
list[].title	string
list[].idx	int	集序号
list[].isvip	string	"0" 免费，"1" 锁定。这是字符串，不是布尔值

POST /app/video/playlist

安装包里没有这个路径，但服务端仍接受，GET 和 POST 都可以。请求体与 playlistv2 相同。

data 的字段和 playlistv2 一样。区别是它一次返回该剧全部集，不再按每页 10 条分页。剧 1942 一次返回 count 30、list 30 条，其中免费的 3 集有 src，其余为空。第一集的 src 与 playlistv2 第一页相同。脚本优先调用这个接口，结果为空、条数少于 count 或请求失败时，再按页调用 playlistv2。

playlistv1 和 playlistv3 返回 nginx 404。

POST /app/video/playlistv2

这是播放地址接口。vid 是剧 id，不是集 id。

请求体：

{"vid": 1942, "page": 1, "before": 1}

第一页 before 为 1，后面的页为 0。每页 10 集。data.count 到齐后停止。

data：

字段	类型	说明
count	int	总集数
list[].cid	int	集 id
list[].idx	int	集序号
list[].msg	string	例如 EP.1
list[].src	string	主 m3u8。未解锁时是空字符串
list[].state	string	例如 pause
list[].like	int
list[].like_n	int
list[].playNumber	int
list[].fufei	int
list[].playIng	bool
list[].isShowimage	bool
list[].needScore	string
list[].isplay	bool

游客和未购买账号只能拿到免费集的 src。锁定集的 src 为空，接口不会因为换了登录方式就返回地址。

src 是 BunnyCDN 签名地址，形如：

https://vz-<编号>.b-cdn.net/bcdn_token=<签名>&token_path=%2F<视频uuid>%2F&expires=<unix时间>/<视频uuid>/playlist.m3u8

签名写在路径里，不是查询字符串。主列表里有一行相对路径 1080p/video.m3u8。子列表是点播，分片名为 video0.ts、video1.ts。同一段签名前缀可以访问该视频目录下的子列表和 ts。签名会过期，需要时重新请求 playlistv2。

POST /app/video/videoinfo

请求体：

{"vid": 1942}

data：

字段	类型
moshi	int
video.id	int
video.title	string
video.view	int
video.desc	string
video.ishot	string
video.like	int
video.is_on	int
video.poster	string
video.forstaus	string
video.author	string
video.forstausen	string

带已登录账号时，data 里还出现过 history。

POST /app/video/addreadlog

App 播放时发出的请求体如下，返回格式没有单独保存：

{"vid": 2286, "del": 0, "cid": 26125}

vid 是剧 id，cid 是集 id。

其他已核对接口

POST /app/open/contact

请求体：{}

data：

字段	类型
techniacl_email	string
business_email	string

字段名在服务端就是 techniacl_email。

POST /app/appopen/getAuthConfig

请求体：{}

data：

字段	类型	说明
platform	string
google.enabled	bool
google.android_client_id	string
google.ios_client_id	string
google.web_client_id	string
google.client_id	string
google.server_client_id	string
apple.enabled	bool
apple.service_id	string
apple.team_id	string
apple.key_id	string
supported_platforms	string[]

安装包中的路径

这些路径从 libapp.so 提取。除上面已写明的接口外，访问方式和返回格式都还没有核对。

认证：

• POST /app/user/appleLogin
• POST /app/user/googleLogin
• POST /app/user/bindEmail
• POST /auth/register
• POST /auth/refresh
• POST /auth/bind-email

用户：

• /app/user/accountBindingStatus
• /app/user/editProfile
• /app/user/changePassword
• /app/user/deleteAccount
• /app/user/activate
• /app/user/activationSubOverview
• /app/user/getPlatformBinds
• /app/user/getSensorsProfile
• /app/user/recordAttribution
• /app/user/readhistory
• /app/user/delhistory

视频：

• /app/video/overview
• /app/video/addToWishlist
• /app/video/markvideo
• /app/video/exitRecommendm
• /app/video/screening
• /app/User/checkViewTime

支付和订阅：

• /app/pay/google_iap_create_order
• /app/pay/google_iap_verify
• /app/pay/google_iap_status
• /app/pay/google_iap_recovery
• /app/pay/apple_iap_create_order
• /app/pay/apple_iap_verify
• /app/pay/apple_iap_recovery
• /app/pay/paylmpay_create_order
• /app/pay/paypal_return
• /app/pay/paypal_cancel
• /app/pay/paystatus
• /app/pay/paysuccess
• /app/pay/initiateCheckout
• /app/pay/report_payment_panel_context
• /app/pay_center/create_order
• /app/pay_center/paylist
• /app/pay_center/third_party_qualification
• /app/user/paylist
• /app/user/paylistv2
• /app/user/paylistv3
• /app/subscription/list
• /app/subscription/cancel

签到、反馈、通知：

• /app/checkin/config
• /app/checkin/status
• /app/checkin/perform
• /app/checkin/history
• /app/checkin/statistics
• /app/checkin/tasks
• /app/feedback/submit
• /app/feedback/list
• /app/feedback/detail
• /app/feedback/read
• /app/feedback/categories
• /app/feedback/unreadCount
• /app/feedback/upload
• /app/notification/getList
• /app/notification/getDetail
• /app/notification/device
• /app/notification/settings
• /app/notification/action
• /app/notification/clear