小羿先森的文章归档 API

基于 GitHub Pages 的文章归档系统 API 文档

API 版本: v1.0

API 概述

本 API 提供对小羿先森网站(xiaoyi.vc)文章的归档访问接口。主要功能包括：

数据结构说明

文章对象结构

{
    "title": "文章标题",
    "date": "2025-02-19T10:53:29",  // 发布时间 ISO 格式
    "lastmod": "2025-02-19T10:53:29",  // 最后更新时间
    "url": "https://xiaoyi.vc/article-url.html",  // 原文链接
    "author": "小羿先森",
    "category": ["分类1", "分类2"],  // 文章分类
    "views": 123,  // 阅读量
    "text_content": "文章正文内容...",  // 格式化后的文本内容
    "images": [  // 文章图片列表
        "https://xiaoyi.vc/wp-content/uploads/2025/02/image1.png",
        "https://xiaoyi.vc/wp-content/uploads/2025/02/image2.png"
    ],
    "download_links": [  // 下载链接列表
        {
            "name": "网盘下载",
            "url": "https://pan.example.com/xxx"
        },
        {
            "name": "项目地址",
            "url": "https://github.com/xxx/xxx"
        }
    ]
}

1. 获取最新文章

GET /data/latest.json

功能描述：

获取网站最新发布或更新的一篇文章信息

使用场景：

响应示例：

{
    "title": "[WIN] Win95 重生版 - 基于 Electron 制作",
    "date": "2025-02-19T10:53:29",
    "lastmod": "2025-02-19T10:53:29",
    "url": "https://xiaoyi.vc/electron-win95.html",
    "author": "小羿先森",
    "category": ["Windows", "怀旧"],
    "views": 1234,
    "text_content": "一款基于 Electron 制作的 Win95 系统重生版...",
    "images": [
        "https://xiaoyi.vc/wp-content/uploads/2025/02/20250219-3.png"
    ],
    "download_links": [
        {
            "name": "网盘下载",
            "url": "https://pan.quark.cn/s/7e8840813dbc"
        },
        {
            "name": "项目地址",
            "url": "https://github.com/felixrieseberg/windows95"
        }
    ]
}

文章内容格式说明

实用提示

接口列表

2. 获取文章索引

GET /data/all.json

功能描述：

获取所有年份的文章统计和索引信息

索引文件层级：

data/
├── all.json           # 总索引文件
├── YYYY/
│   ├── index.json    # 年度索引
│   └── MM/
│       ├── index.json # 月度索引
│       └── DD/        # 日期文件夹
│           ├── index.json    # 当日索引
│           └── articles/     # 文章文件夹

3. 获取年度文章

GET /{year}

返回指定年份的所有月份文章索引

参数 类型 说明
year string 年份，格式：YYYY

4. 获取月度文章

GET /{year}/{month}

返回指定月份的所有文章索引

参数 类型 说明
year string 年份，格式：YYYY
month string 月份，格式：MM

5. 获取每日文章

GET /{year}/{month}/{day}

返回指定日期的所有文章列表

参数 类型 说明
year string 年份，格式：YYYY
month string 月份，格式：MM
day string 日期，格式：DD

实际应用示例

场景一：获取最新文章

  1. 访问 /data/latest.json 获取最新文章
  2. 从响应中获取文章内容和图片资源
  3. 如果有下载链接，可以获取相关资源

场景二：查看历史文章

  1. 访问 /data/all.json 获取年份列表
  2. 选择年份访问 /data/YYYY/index.json
  3. 选择月份访问 /data/YYYY/MM/index.json
  4. 查看具体日期的文章列表

使用说明

使用限制

实用小贴士

每篇文章包含以下信息：