提供古诗词推荐API
各维度得分依据公开资料与字段推算,加权后即综合评分,仅供参考。
今日诗词 API 是一个返回古诗词名句的开放接口,核心特点不是简单随机,而是依据用户所在地、时间、节日、季节、天气、景观和城市等信息进行智能推荐。它面向网站、博客、小程序、移动 App、浏览器插件等需要展示“应景诗词”的场景。
它支持 JSON 和 SVG 图片两类调用形式。普通网站可直接插入 JS SDK,Vue、React 或 Webpack 项目可通过 NPM 包 jinrishici 使用;微信小程序有专门 SDK,安卓提供 Maven/Gradle SDK 及自定义 TextView 控件。iOS、桌面端等非浏览器环境则可使用高级 JSON 接口,通过先获取 Token、再携带 X-User-Token 请求诗句的方式调用。返回内容包含诗句、出处、朝代、作者、整诗、部分翻译、匹配标签、热度和缓存时间等,信息结构较完整。
服务对非盈利使用免费,但明确“不开放商用”。如果以接口或其内容盈利,或在以接口为主体内容的页面放广告,均不符合免费条件。调用量方面,正确配置时原则上无限制,但短时间大量访问会降低推荐质量;5 秒内单 IP 超过 25 次会返回 403。
优点是接入路径非常丰富,文档覆盖安装示例、接口格式、错误码、测试方法和 FAQ;智能推荐比普通一言类接口更适合页面氛围营造。缺点是今日诗词 API 本身暂不开源,免费版不支持服务端调用、Node 环境和服务端渲染;稳定性虽有说明使用 Spring-Boot、WebFlux、Netty、MongoDB、Redis 并部署在腾讯云广州,但免费版本不做可靠性保证。
它适合个人博客、内容站、小程序和客户端应用中作为装饰或文化内容补充,不适合需要商用授权、强 SLA、自托管或后端批量抓取的产品。站点已备案并部署在国内云机房,按文本判断中国大陆访问应为可直连。替代方案可考虑其旧版 gushi.ci API,后者随机返回、配置简单且开源。
本测评基于公开资料整理,不构成购买建议,请以 41v.cn 官网实际信息为准。
可嵌入App/网站/小程序,免费友好。
评分明细(分布与用户短评)接入中。当前展示 TG4G 综合评分,数据源自公开测评与用户反馈。