一言(随机/每日/场景/此刻)
一言(随机/每日/场景/此刻)
GET /saying/random - 一言(随机/每日/场景/此刻)
一言接口,返回一条随机语录。通过 mode 参数切换四种返回方式,并支持按来源、分类、标签过滤。
四种模式(mode)
- random(默认):每次调用随机返回一条语录。
- daily:同一天内返回固定的同一条,适合每日打卡、签到等场景。
- recommend:配合 scene 参数,返回指定场景(如 night、morning)的语录。
- moment:根据请求时所处时段,自动返回应景语录。
语言控制
语料分中英文两类,可通过 source 或 category 控制:
- 需要中文:source 选「综合句子语料库 / 曹星宇句子集」,或 category 选中文分类(如 影视、文学、诗词)。
- 需要英文:source 选「Quotable / 英文历史名言」。
使用须知
[!NOTE]
- source、category、tag 支持多值,用英文逗号 , 或分号 ; 分隔。
- scene 仅在 mode=recommend 时生效且必填,其他模式下会被忽略。
- 请求示例:
- 随机:GET /api/v1/saying/random
- 每日:GET /api/v1/saying/random?mode=daily
- 场景:GET /api/v1/saying/random?mode=recommend&scene=night
- 此刻:GET /api/v1/saying/random?mode=moment