关于 biodays
biodays://about

biodays

“实验室科学史上的今天”:每天一则发生在该月该日的实验室故事,或者是一些好玩的生物学小知识。

每天怎么选故事

服务端以 Asia/Shanghai(+08:00)判断“今天”, 查找同月同日的条目;同日有多条时优先随机推荐未读故事,不限制故事编号。

数据尚未覆盖的日期会随机推荐一篇并加以标注,也可通过 fallback=none 关闭,直接得到 404。

数据覆盖
故事总数
408 篇
覆盖范围
1-12月
季度
Q1、Q2、Q3、Q4

统计包含所有编号的故事,季度与月份按故事日期计算。月份覆盖不代表每天都有故事,缺口日期会随机推荐。

公开 API

版本化 REST API,前缀 /api/v1,完整定义见 Swagger 文档。

GET /api/v1/today今日故事。支持 tz(时区偏移)与 fallback(random / none)。
GET /api/v1/stories故事列表。month、day、tag、q、page、page_size,按时间线排序。
GET /api/v1/stories/{id}单篇详情,包含正文与来源引用。
GET /api/v1/stories/random随机一篇,可用 exclude 排除正在展示的 id。
GET /api/v1/tags全部标签与故事计数。
GET /api/v1/meta数据集概况:总数、季度与月份覆盖。
GET /healthz健康检查,不参与限流。

错误码

INVALID_PARAM400参数校验失败,例如 month=13
STORY_NOT_FOUND404id 不存在,或当日无故事且 fallback=none
RATE_LIMITED429触发单 IP 限流
INTERNAL_ERROR500未预期错误
来源与版权

每篇故事基于专利、论文、诺奖新闻稿或机构档案整理改写,文末标注引用并尽可能给出原文链接。 正文是面向读者的叙述,不是文献原文,历史细节以原始来源为准。

如发现事实、年份或引用有误,欢迎指出。转载请注明出处。

408 篇
biodays