数据接口说明

📊 个人网站数据接口说明

本站除展示文章外,还公开部分结构化数据,存放于 /api/ 目录下,以 JSON 为主,供站内脚本与外部程序读取使用。
这些文件不仅是网站内容的底层数据源,也记录着个人的学习轨迹、成长进步与思考足迹,见证知识体系的不断演化。

一、设计原则

  • 公开透明:数据化自己,用可追溯的方式记录学习、创作与成长。
  • 可复用:允许任何人在合理引用的前提下使用这些数据。
  • 持续演化:以长期主义为信念,让数据在时间中积累、更新与生长。

二、文件列表

文件 说明 主要字段
/tags.json 技术文章索引,按标签分类,每个标签包含若干 [标题, URL] [[tag_name, [[title, url], … ]], …]
/reading.json 阅读笔记索引,分领域、子领域及条目 [[领域, [[子领域, 字数, [条目] ], …]], …]
/api/book_list.json 阅读书单,含评分与简评 title, author, publisher, finish_date, rating, comment, note
/api/cnt_github_repo.json GitHub 仓库统计信息 repo, stars, forks, language, …
/api/achievement.json 综合统计数据:博客数、读书数、知乎赞同数、Star 数等 各项计数值
/api/certification.json 职业与专业证书 category, title, organization, link, image

三、示例用法

# 下载书单
curl https://www.guofei.site/api/book_list.json -o book_list.json