苹果CMS的API接口说明

项目	说明
基础路径	/api.php
请求方式	GET（除特别说明外）
返回格式	默认 JSON；部分 Provide 聚合接口支持 XML（at=xml）
配置/主题/广告接口	见「十二、Config」— get_config, get_extra_var, get_tpl_config, get_mctheme, get_ads_files
通用返回结构（成功）	{"code":1,"msg":"获取成功","info":{...}}；列表 info 含 offset, limit, total, rows；详情 info 为对象或数组

接口	路径	参数	返回说明
视频搜索联想	GET /api.php/vod/suggest	wd（必填）, limit（1‑20，默认10）	成功 code=1，含 list（{id,name,en,pic,vod_link}）及 url（搜索结果页链接）；code=999 表示搜索关闭
视频列表条件搜索	GET /api.php/vod/get_list/	与四、1) 列表参数相同（vod_name, type_id, orderby, offset, limit 等）	分页 JSON，rows 含 vod_link, vod_pic 等
文章列表条件搜索	GET /api.php/art/get_list/	与四、2) 列表参数相同（name, tag, type_id 等）	分页 JSON
漫画列表关键字搜索	GET /api.php/manga/get_list/	wd（非空）对 manga_name 模糊匹配；可与 t, ids, page, limit 组合	分页 JSON
Provide 采集按关键字拉数据	/api.php/provide/{vod\|art\|actor\|role\|website\|manga}/ ac=list	ac=list 时支持 wd 关键字，pg 页码，pagesize 每页条数	JSON 或 XML（at=xml）

模块	路径	主要参数	说明
视频(Vod)	/api.php/provide/vod/	ac=list/detail/videolist, at=json/xml, t, ids, pg, pagesize(≤100), wd, h(小时), year, isend, from, sort_direction	ac=list 精简字段；ac=detail/videolist 完整字段（含播放组）
文章(Art)	/api.php/provide/art/	ac=list/detail, t, ids, pg, wd, h, pagesize	同 Vod 语义
演员(Actor)	/api.php/provide/actor/	ac=list/detail, t, ids, pg, wd, h, pagesize	同 Vod 语义
角色(Role)	/api.php/provide/role/	ac=list/detail, t, ids, pg, wd, h, pagesize	同 Vod 语义
网址(Website)	/api.php/provide/website/	ac=list/detail, t, ids, pg, wd, h, pagesize	同 Vod 语义
漫画(Manga)	/api.php/provide/manga/	ac=list/detail, t, ids, pg, wd, h, pagesize	同 Vod 语义
评论(Comment)	/api.php/provide/comment/	无实际逻辑	预留空实现

类别	说明
列表接口	统一支持 offset, limit, orderby 等参数，详见各模块表格
详情接口	统一以 {xxx_id} 为必填参数（如 vod_id, art_id）

接口功能	路径	参数	返回说明
更新/获取点击数	GET /api.php/vod/update_hits	id(必填), type(可选, "update"则自增)	{code:1, data:{hits, hits_day, hits_week, hits_month}}
顶/踩	GET /api.php/vod/digg	id(必填), type(up/down)	{code:1, data:{up, down}}，Cookie 30秒防重复
评分	GET /api.php/vod/update_score	id(必填), score(1‑10)	{code:1, data:{score, score_num, score_all}}
验证密码	GET /api.php/vod/verify_pwd	id, pwd, type(1访问/4播放/5下载)	{code:1, msg:'ok'}，5秒频率限制
获取播放页信息	GET /api.php/vod/get_play_info	id, sid(默认1), nid(默认1)	返回 vod_play_list, current, play_url 等
获取下载页信息	GET /api.php/vod/get_down_info	id, sid(默认1), nid(默认1)	返回 down_list, current 等
列表	GET /api.php/vod/get_list/	offset, limit(≤500), orderby, type_id, vod_name, vod_tag, vod_actor, vod_area, vod_year, vod_isend 等	rows 含 vod_link, vod_pic, type_is_vip_exclusive
详情	GET /api.php/vod/get_detail/	vod_id(必填)	完整影片信息
年份列表	GET /api.php/vod/get_year/	type_id_1(必填)	年份数组
分类列表	GET /api.php/vod/get_class/	type_id_1(必填)	分类数组
地区列表	GET /api.php/vod/get_area/	type_id_1(必填)	地区数组
Banner推荐	GET /api.php/vod/get_banner/	num(默认5), start(0), level(默认9)	含 vod_link, vod_pic_slide
热门推荐	GET /api.php/vod/get_hot/	num(6), type_id, start(0), level, by(hits_month等)	热门列表
按分类最新	GET /api.php/vod/get_latest_by_type/	type_id(必填), num(24), start(0)	含 today_new_count
排行榜	GET /api.php/vod/get_rank/	type_id, num(10), start(0), by(hits_month等)	排行列表

接口功能	路径	参数	返回说明
列表	GET /api.php/art/get_list/	type_id, offset, limit, tag, orderby, name, sub, blurb, class, level, time_start/end 等	分页列表
详情	GET /api.php/art/get_detail/	art_id(必填)	文章完整信息
阅读单页	GET /api.php/art/get_read_page/	art_id, page(默认1)	{can_read, content_html, deny_msg, page_total}
最新文章	GET /api.php/art/get_latest/	num(24), type_id, start(0)	含 art_link, art_pic, art_time_text
热门文章	GET /api.php/art/get_hot/	num(6), type_id, start(0), by(time/hits…)	热门列表
顶/踩	GET /api.php/art/digg	id(必填), type(up/down)	同视频 digg
更新/获取点击数	GET /api.php/art/update_hits	id, type(可选 update)	同视频 update_hits
评分	GET /api.php/art/update_score	id, score	同视频评分

接口功能	路径	参数	返回说明
列表	GET /api.php/actor/get_list/	offset, limit, id, type_id, sex, area, letter, level, name, blood, starsign, time_start/end, orderby	分页列表
详情	GET /api.php/actor/get_detail/	actor_id(必填)	演员完整信息
推荐明星	GET /api.php/actor/get_recommend/	ids, num(8), start(0), by	含 actor_link, actor_pic

接口功能	路径	参数	返回说明
列表	GET /api.php/comment/get_list/	rid(必填), mid(必填), offset(0), limit(20), orderby(time/up/down/id)	rows 含 sub 子楼，user_portrait, comment_content（表情替换）, comment_time_label 等
提交评论	POST /api.php/comment/submit	comment_mid, comment_rid, comment_content, comment_pid(0), comment_name(游客昵称)	受登录/审核/频率限制
举报	GET /api.php/comment/report	id(comment_id)	{code:1, msg:'ok'}
顶/踩	GET /api.php/comment/digg	id, type(up/down)	{code:1, data:{up, down}}

接口功能	路径	参数	返回说明
列表	GET /api.php/gbook/get_list/	offset, limit, id, rid, user_id, status, name, content, orderby, time_start/end	分页列表
提交留言	POST /api.php/gbook/submit	gbook_content(必填), gbook_name(游客昵称)	受登录/审核/频率限制
举报	GET /api.php/gbook/report	id(gbook_id)	{code:1, msg:'ok'}

接口功能	路径	参数	返回说明
列表	GET /api.php/link/get_list/	offset, limit, id, type, name, sort, time_start/end, orderby	分页列表

接口功能	路径	参数	返回说明
列表	GET /api.php/topic/get_list/	offset, limit, time_start/end, orderby(id/time/time_add/score/hits…)	分页列表
详情	GET /api.php/topic/get_detail/	topic_id(必填)	专题完整信息
推荐专题	GET /api.php/topic/get_recommend/	num(5), start(0), by(time/hits)	含 topic_link, topic_pic, topic_pic_slide

接口功能	路径	参数	返回说明
分类树（顶级含children）	GET /api.php/type/get_list/	type_id(可选，筛选顶级)	分类对象含 children 数组
全部顶级分类	GET /api.php/type/get_all_list/	无	顶级分类列表
导航栏分类（含子分类+扩展）	GET /api.php/type/get_nav_types/	ids, num, mid, parent(1返回父级)	每条含 type_extend 和 children
分类及子分类	GET /api.php/type/get_type_with_children/	type_id(必填父ID), num	父对象含 children 数组

接口功能	路径	参数	返回说明
用户列表	GET /api.php/user/get_list/	offset, limit, name, nickname, email, qq, phone, time_start/end, group_id, orderby	分页列表（仅管理员）
用户详情	GET /api.php/user/get_detail/	id(必填)	用户信息
分销推广下线列表	GET /api.php/user/get_reward_list	level(1‑3), page, limit(≤100)	下线列表
以下接口需登录
登录	POST /api.php/user/login	user_name, user_pwd	{code:1, msg:'登录成功', info:{user_id,...}}
注册	POST /api.php/user/register	user_name, user_pwd, 可选user_email, user_phone, invite_code	注册成功
退出	任意方法 /api.php/user/logout	无	{code:1, msg:'已退出登录'}
当前用户资料	GET /api.php/user/get_info	无	用户表常用字段 + user_portrait
更新资料	POST /api.php/user/update_info	user_nick_name, user_email, user_phone, user_qq, 改密传user_old_pwd+user_new_pwd	更新成功
用户行为日志(浏览/收藏等)	GET /api.php/user/get_ulog	page, limit, type(1‑5), mid	分页日志列表
添加/更新行为日志	POST /api.php/user/add_ulog	mid, rid, type, sid, nid	添加成功
删除行为日志	POST /api.php/user/del_ulog	ids 或 all=1 且 type=1‑5	删除成功
积分日志	GET /api.php/user/get_plog	page, limit, filter=income/expense	分页积分日志
删除积分日志	POST /api.php/user/del_plog	ids 或 all=1	删除成功
充值订单列表	GET /api.php/user/get_orders	page, limit	订单列表
找回密码发码	POST /api.php/user/find_password	user_email 或 user_phone	发送验证码
邀请信息	GET /api.php/user/get_my_invite	无	邀请码及统计
邀请记录列表	GET /api.php/user/get_invite_list	page, limit	邀请记录
批量收藏状态	GET /api.php/user/get_favorites_status	vod_ids(逗号分隔), mid(1), ulog_type(2)	{rows:[{rid, is_fav, ulog_id}]}
登录/注册一体化	POST /api.php/user/login_or_register	user_name, user_pwd, invite_code	自动登录或注册，返回 action 和 info
升级页数据(会员信息+可购套餐)	GET /api.php/user/ajax_upgrade_data	无（未登录也可）	{is_login, user_points, groups:[{group_id, group_name, price_day,...}]}
会员现金升级（创建UPG订单）	POST /api.php/user/upgrade_order_create	group_id, long(day/week/month/year)	{order_code, order_price, pay_url}

接口功能	路径	参数	返回说明
列表	GET /api.php/website/get_list/	offset, limit, type_id, name, sub, en, status, letter, area, lang, level, start/end_time, tag, orderby	分页列表
详情	GET /api.php/website/get_detail/	website_id(必填)	网址完整信息

接口功能	路径	参数	返回说明
列表	GET /api.php/manga/get_list/	page, limit, t(type_id), ids, wd, order	分页列表
详情	GET /api.php/manga/get_detail/	id(漫画ID)	漫画完整信息
单话阅读	GET /api.php/manga/get_chapter/	id, sid, nid(默认1)	{can_read, images:[], deny_msg, episode_total}
最新漫画	GET /api.php/manga/get_latest/	num(24), start(0)	含 manga_link, manga_pic, manga_time_text
热门漫画	GET /api.php/manga/get_hot/	num(6), start(0), by(hits_month等)	热门列表

接口功能	路径	参数	返回说明
获取配置	GET /api.php/config/get_config/	无	{site_banner:[], site_app_launch_image:""}
预留参数（扩展分类/地区等）	GET /api.php/config/get_extra_var/	无	{vod_extend_area:[], vod_extend_year:[], art_extend_class:[], vod_extend_class:[], extra_var:{}}
站点壳层 + config.json	GET /api.php/config/get_tpl_config/	无	{site:{...}, features:{...}, search:{...}, tpl_config:{...}}（tpl_config来自模板config.json）
主题配置（与PC模板assign同源）	GET /api.php/config/get_mctheme/	无	{template_dir, mctheme:{theme.ad_slots, theme.ads}}（与mctheme.php一致）
广告脚本文件清单	GET /api.php/config/get_ads_files/	无	{template_dir, ads_dir, files:[{name, path, url}]}（扫描模板/ads/*.js）

接口功能	路径	参数	返回说明
获取当前用户状态	GET /api.php/auth/me/	无（携带cookie）	{is_login, user_id, user_name, nick_name, group_id, points, user_portrait, vip_expire_time}
获取资源权限	GET /api.php/auth/permission/	mid(1/2/6), id, action(play/read/download/comment/favorite)	{is_login, is_vip, can_play, can_read, can_download, can_comment, can_favorite, deny_reason}

接口功能	路径	参数	返回说明
列表	GET /api.php/role/get_list/	offset, limit, rid, name, letter, level, actor, orderby	分页列表
详情	GET /api.php/role/get_detail/	role_id(必填)	含关联视频 vod_info
推荐	GET /api.php/role/get_recommend/	rid, num(8), by, level	推荐角色列表

接口功能	路径	参数	返回说明
订单列表	GET /api.php/order/get_list	page, limit, status(0/1)	分页列表
订单详情	GET /api.php/order/get_detail	order_id 或 order_code	订单详情
查询订单状态	GET /api.php/order/check_status	order_code(必填)	{order_code, order_price, order_status, order_status_text, order_pay_type, ...}

接口功能	路径	参数	返回说明
获取支付配置	GET /api.php/payment/get_config	无	{min, scale, methods:[{key,name,enabled,paytypes?}], card_config, is_login, user_points}
发起支付（收银台）	POST /api.php/payment/gopay	order_code, order_id, payment(小写), paytype(子通道)	{payment, order_code, order_price, payment_data:{type, ...}}
支付回调通知	GET/POST /api.php/payment/notify?pay_type={type}	由支付平台回调	异步处理，更新订单状态
卡密充值	POST /api.php/payment/use_card	card_no, card_pwd	{code:1, msg:'充值成功，增加积分xxx'}
积分购买内容权限	POST /api.php/payment/buy_popedom	mid, id, type(1/4/5), sid, nid	购买成功或积分不足
会员升级（积分）	POST /api.php/payment/upgrade	group_id, long(day/week/month/year)	{code:1, msg:'升级成功'}
获取可升级的用户组列表	GET /api.php/payment/get_groups	无	付费用户组列表及所需积分
充值卡使用记录	GET /api.php/payment/get_cards	page, limit	分页使用记录

接口功能	路径	参数	返回说明
获取提现配置	GET /api.php/cash/get_config	无	{cash_status, cash_min, cash_ratio}
提现列表	GET /api.php/cash/get_list	page, limit, status	分页列表
提现详情	GET /api.php/cash/get_detail	cash_id	提现记录详情
提交提现申请	POST /api.php/cash/create	cash_money, cash_bank_name, cash_bank_no, cash_payee_name	提交成功，积分冻结
删除提现记录	POST /api.php/cash/del	ids 或 all=1	删除成功，恢复积分

步骤	推荐接口/页面	说明
1. 获取支付配置	GET /api.php/payment/get_config	获取支付方式、兑换比例、最小充值金额
2. 创建订单	GET user/buy（页面）或 POST /api.php/order/create	返回订单号 order_code（前缀PAY）
3. 发起支付	POST /api.php/payment/gopay	根据 payment_data 展示二维码或跳转
4. 查询订单状态	GET /api.php/order/check_status?order_code=xxx	轮询获取支付结果，info.order_status=1 表示成功

模块	接口功能	路径	参数	返回说明
Chatroom聊天室	获取聊天消息列表	GET /api.php/chatroom/get_list	vod_id(必填), after_id(增量), limit(≤100)	消息列表，支持增量拉取
	发送聊天消息	POST /api.php/chatroom/send	vod_id, content(≤500)	需登录，3秒频率限制
	举报聊天消息	POST /api.php/chatroom/report	chat_id	举报成功
Danmaku弹幕	获取弹幕列表	GET /api.php/danmaku/get_list	vod_id, sid, nid, limit(≤2000)	弹幕数组
	DPlayer兼容弹幕接口	GET/POST /api.php/danmaku/dplayer	GET: id={vod_id}-{sid}-{nid} POST: id, time, type, color, text	GET返回DPlayer标准格式；POST发送弹幕
	发送弹幕	POST /api.php/danmaku/send	vod_id, sid, nid, time, text, type(0/1/2), color	需登录，5秒频率限制
	举报弹幕	POST /api.php/danmaku/report	danmaku_id	举报成功

模块	接口功能	路径	参数	返回说明
Novel小说	列表	GET /api.php/novel/get_list	page, limit, t(type_id), ids, wd, order	分页列表
Novel小说	详情	GET /api.php/novel/get_detail	id	小说详情
Task任务签到	获取任务列表及状态	GET /api.php/task/get_task_list	无	{daily_tasks, newbie_tasks, sign_info, today_earned, user_points}
	每日签到	POST /api.php/task/daily_sign	无	签到成功，返回获得积分
	获取签到信息（含里程碑）	GET /api.php/task/get_sign_info	无	{serial_days, total_days, milestones}
	领取签到里程碑奖励	POST /api.php/task/claim_sign_milestone	milestone_id	领取成功
	领取任务奖励	POST /api.php/task/claim_reward	task_id	领取成功
	上报每日任务进度	POST /api.php/task/report_progress	task_action(watch_vod/share_vod/post_comment)	上报成功

模块	接口功能	路径	参数	返回说明
Receive数据接收	推送视频	/api.php/receive/vod	pass(≥16位), vod_name, type_id/type_name, 其他视频字段	需后台开启 interface.status=1 且配置密码，验证 pass
	推送文章	/api.php/receive/art	pass, art_name, type_id/type_name
	推送演员	/api.php/receive/actor	pass, actor_name, actor_sex, type_id/type_name
	推送角色	/api.php/receive/role	pass, role_name, role_actor, vod_name/douban_id
	推送网址	/api.php/receive/website	pass, website_name, type_id/type_name
	推送评论	/api.php/receive/comment	pass, comment_name, comment_content, comment_mid, rel_name/douban_id
Sycms采集转换	主入口	GET /api.php/sycms/index	ac(list/detail/class), t, pg, limit(≤100), wd, ids	返回MacCMS标准采集JSON
	获取分类列表	GET /api.php/sycms/getClassList	无	分类数组
	获取视频列表	GET /api.php/sycms/getVideoList	同主入口	视频列表
	测试连接	GET /api.php/sycms/test	无	连接测试
Timming定时任务	执行入口	GET /api.php/timming/index	name(任务名), enforce(1强制执行)	由cron调用，根据后台配置执行采集/生成/缓存/推送
Wechat微信公众号	消息接入	GET/POST /api.php/wechat/index	GET含echostr用于验证；POST接收用户消息	验证或自动回复

❤️收藏 👍点赞

苹果CMS的API接口说明

用户评论

发表评论