HTTP 服务
使用 amagi 启动本地 HTTP 服务
HTTP 服务
amagi 内置了 Express 服务器，可以一键启动本地 HTTP 服务。
启动服务
import from '@ikenxuan/amagi'
const = ({
: {
: 'SESSDATA=xxx; bili_jct=yyy',
: 'ttwid=...',
: 'did=...',
: 'a1=...'
}
})
// 启动服务，默认端口 4567
.(4567)启动后访问：
- 根路径
/会重定向到 API 文档 - API 文档：https://amagi.apifox.cn
路由结构
所有 API 路由挂载在 /api/<platform> 下：
/api/douyin/*- 抖音相关接口/api/bilibili/*- B站相关接口/api/kuaishou/*- 快手相关接口/api/xiaohongshu/*- 小红书相关接口
平台路由
| 路由 | 说明 | 参数 | |------|------|------| | GET /fetch_one_work | 聚合解析 | aweme_id | | GET /fetch_work_comments | 评论数据
| aweme_id, number?, cursor? | | GET /fetch_user_info | 用户主页数据 | sec_uid | | GET /fetch_user_post_videos |
用户视频列表 | sec_uid | | GET /fetch_search_info | 搜索数据 | query, number?, search_id? | | GET /fetch_suggest_words |
热点词数据 | query, number? | | GET /fetch_music_work | 音乐数据 | music_id | | GET /fetch_emoji_list | Emoji 列表 | - | |
GET /fetch_emoji_pro_list | 动态表情列表 | - | | GET /fetch_user_live_videos | 直播间信息 | sec_uid | | GET /fetch_video_comment_replies | 评论回复 | aweme_id, comment_id, number?, cursor? | | GET /fetch_work_danmaku | 弹幕数据 |
aweme_id, duration, start_time?, end_time? |
| 路由 | 说明 | 参数 | |------|------|------| | GET /fetch_one_video | 视频数据 | bvid | | GET /fetch_video_playurl | 视频下载信息
| avid, cid | | GET /fetch_work_comments | 评论数据 | oid, type, pn?, number? | | GET /fetch_user_profile | 用户主页数据
| host_mid | | GET /fetch_user_dynamic | 用户动态列表 | host_mid | | GET /fetch_emoji_list | Emoji 列表 | - | | GET /fetch_bangumi_video_info | 番剧信息 | ep_id 或 season_id | | GET /fetch_bangumi_video_playurl | 番剧下载信息 | cid, ep_id |
| GET /fetch_dynamic_info | 动态详情 | dynamic_id | | GET /fetch_dynamic_card | 动态卡片 | dynamic_id | | GET /fetch_live_room_detail | 直播间信息 | room_id | | GET /fetch_liveroom_def | 直播间初始化 | room_id | | GET /login_basic_info |
登录信息 | - | | GET /new_login_qrcode | 申请二维码 | - | | GET /check_qrcode | 二维码状态 | qrcode_key | | GET /fetch_user_full_view | UP主总播放量 | host_mid | | GET /av_to_bv | AV 转 BV | avid | | GET /bv_to_av | BV 转 AV | bvid |
| 路由 | 说明 | 参数 | |------|------|------| | GET /fetch_one_work | 视频数据 | photoId | | GET /fetch_work_comments | 评论数据 |
photoId | | GET /fetch_user_profile | 用户主页数据 | principalId | | GET /fetch_user_work_list | 用户作品列表 | principalId,
pcursor?, count? | | GET /fetch_live_room_info | 直播间信息 | principalId | | GET /fetch_emoji_list | Emoji 列表 | - |
| 路由 | 说明 | 参数 | |------|------|------| | GET /fetch_home_feed | 首页推荐 | cursor_score?, num?, refresh_type?,
note_index?, category?, search_key? | | GET /fetch_one_note | 笔记数据 | note_id, xsec_token | | GET /fetch_note_comments
| 评论数据 | note_id, xsec_token, cursor? | | GET /fetch_user_profile | 用户数据 | user_id | | GET /fetch_user_notes |
用户笔记 | user_id, cursor?, num? | | GET /fetch_emoji_list | 表情列表 | - | | GET /fetch_search_notes | 搜索笔记 | keyword,
page?, page_size?, sort?, note_type? |
响应格式
所有接口返回统一的 JSON 格式：
{
"success": true,
"code": 200,
"message": "获取成功",
"data": { ... },
"requestPath": "/api/bilibili/fetch_one_video?bvid=BV1xx411c7mD"
}{
"success": false,
"code": 400,
"message": "参数错误",
"error": {
"name": "ZodError",
"details": [ ... ]
},
"requestPath": "/api/douyin/fetch_work_comments?aweme_id=..."
}自定义路由
你也可以单独注册平台路由到自己的 Express 应用：
import from '@ikenxuan/amagi/express'
import { , } from '@ikenxuan/amagi'
const = ()
// 注册路由
.('/api/bilibili', ('your_cookie', {}))
.('/api/douyin', ('your_cookie', {}))
.(3000)