获取番剧信息

基础信息

• 基础URL: api/animes
• 支持方法: GET
• 内容类型: application/json
• CORS: 支持跨域请求

端点列表

1. 获取番剧列表

GET /api/animes

NOTE

我们建议您在使用过程中添加pageSize分页参数。

查询参数

参数	类型	必需	默认值	说明
page	integer	否	1	页码
pageSize	integer	否	20	每页数量
keyword	string	否	-	搜索关键词
season	string	否	-	季度筛选 (如: 2024-1)
status	string	否	all	状态筛选 (all/ongoing/completed)
sortBy	string	否	title_chinese	排序字段
sortOrder	string	否	asc	排序方向 (asc/desc)

响应示例

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "anime_id": 254,
      "title_original": "アルネの事件簿",
      "title_chinese": "阿尔涅的事件簿",
      "title_other_aliases": null,
      "original_work_type": "游戏改编",
      "description": "世上有两种人...",
      "total_episodes": 12,
      "episodes_announced": null,
      "is_ongoing": 1,
      "is_short_series": 0,
      "has_multiple_versions": 0,
      "official_website": "arne.asmik-ace.co.jp",
      "special_notes": "共12集",
      "season_id": 11,
      "created_at": "2025-12-20 02:53:49",
      "updated_at": "2025-12-20 18:20:34",
      "year": 2026,
      "quarter": "冬"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 20,
    "total": 61,
    "totalPages": 4
  }
}

2. 获取单个番剧详情

GET /api/animes/{id}

路径参数

参数	类型	必需	说明
id	integer	是	番剧ID

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "anime_id": 254,
    "title_original": "アルネの事件簿",
    "title_chinese": "阿尔涅的事件簿",
    "description": "详细描述...",
    "total_episodes": 12,
    "is_ongoing": 1,
    "season_id": 11,
    "tags": [
      {
        "tag_id": 1,
        "tag_name": "悬疑",
        "tag_category": "题材"
      }
    ],
    "cover_image": {
      "media_url": "/images/posters/254.jpg",
      "media_alt": "阿尔涅的事件簿海报"
    }
  }
}

3. 获取番剧标签

GET /api/animes/{id}/tags

响应示例

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "tag_id": 1,
      "tag_name": "悬疑",
      "tag_category": "题材"
    },
    {
      "tag_id": 2,
      "tag_name": "奇幻",
      "tag_category": "题材"
    }
  ]
}

4. 搜索番剧

GET /api/animes/search

查询参数

参数	类型	必需	说明
q	string	是	搜索关键词
limit	integer	否	20

5. 获取番剧统计

GET /api/animes/stats

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total_animes": 61,
    "ongoing_animes": 61,
    "completed_animes": 0,
    "total_episodes": 732,
    "average_episodes": 12.0,
    "by_year": {
      "2026": 61
    },
    "by_quarter": {
      "冬": 61
    }
  }
}