一句话生成的每日一言 API

举报
wdxb 发表于 2026/08/18 11:17:57 2026/08/18
【摘要】 作品地址:开发者作品展览馆 https://gallery.developer.huaweicloud.cn/gallery/0-11d97eb2400000作品简介:基于Flask的中文名言API,收录60条经典名言,提供前端首页与接口服务。每日一言 API — 项目介绍项目概述每日一言 API 是一个基于 Python + Flask 构建的中文名言随机接口服务,同时提供精美的前端首页...
每日一言 API preview

每日一言 API — 项目介绍

项目概述

每日一言 API 是一个基于 Python + Flask 构建的中文名言随机接口服务,同时提供精美的前端首页展示页面。项目收录了 60 条经典中文名言,涵盖励志、哲理、诗词、生活感悟四大类别,用户可通过网页首页或 RESTful API 获取随机一言或按类别筛选。

系统架构图

核心功能

前端首页

项目提供了一个优雅的中文风格单页前端首页,具有以下特性:

  • 渐变标题区:赤陶→暖橙→雅金渐变背景,配以装饰光晕效果
  • 中央卡片展示:大字展示一言内容、作者及类别标签,卡片带圆角阴影和淡入动画
  • 交互按钮:「换一条」按钮支持随机获取新一言并带有旋转加载动画;「今日一言」按钮获取当天固定一言
  • 类别筛选:支持按励志、哲理、诗词、生活感悟四个类别筛选
  • 响应式布局:适配手机端和桌面端

RESTful API

所有 API 接口统一使用 /api 前缀,返回标准 JSON 格式:

端点 说明 返回格式
GET /api/quote 随机返回一条一言 {id, content, author, category}
GET /api/today 根据日期确定性返回一言 同上,同一天返回同一条
GET /api/category/ 按类别随机返回一言 同上
GET /api/all 返回全部一言列表 {categories, quotes}
GET /api/health 健康检查 {status, totalquotes, categories}

技术栈

  • 后端:Python 3.12 + Flask 3.0.3
  • 跨域:flask-cors 4.0.1
  • 前端:纯原生 HTML/CSS/JS(无外部框架依赖)
  • 数据:内置 60 条中文名言,Python 字典结构

项目结构

daily-quote-api/
├── app.py              # Flask 主应用,路由定义
├── quotes.py           # 名言数据与查询函数
├── requirements.txt    # Python 依赖
├── templates/
│   └── index.html      # 前端首页(内嵌 CSS/JS)
└── README.md           # 项目说明

名言数据

项目收录 60 条中文名言,分布如下:

  • 励志(15条):如"天行健,君子以自强不息"
  • 哲理(15条):如"穷则独善其身,达则兼济天下"
  • 诗词(15条):如"举头望明月,低头思故乡"
  • 生活感悟(15条):如"你若盛开,蝴蝶自来"

设计亮点

1. 确定性一言:/api/today 接口根据当天日期计算索引,确保同一天返回同一条一言,适合每日推送场景

2. 零依赖前端:前端页面无需任何外部框架或 CDN,所有 CSS/JS 内嵌于 HTML

3. CORS 跨域支持:全局开启 CORS,方便第三方应用调用 API

4. 温暖配色:前端采用米白底色 + 深色文字 + 暖色强调的中文优雅风格

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。