API 文档 · 星语

接口地址

支持 GET / POST（表单或 JSON），已开启跨域（CORS），返回 UTF-8。

在线调试

接口 action 星座 sign 生日 birthday 周期 type 日期 date 格式 format 来源 source 缓存 fresh

点击「发送请求」查看返回结果

接口示例

请求参数

参数	说明
action	可选，默认 fortune fortune 运势 · sign 生日 / 名称查星座 · signs 十二星座列表
sign	星座：英文 key（aries）、中文（白羊座 / 白羊）、符号（♈）或 random 随机
birthday	生日，可替代 sign：1996-10-16、10-16、10月16日
type	默认 today today 今日 · tomorrow 明日 · week 周 · day 指定日（配合 date）
date	YYYY-MM-DD。type=day 返回当天运势，type=week 返回该日所在一周
format	默认 json json · text 纯文本 · png 海报图片 · svg 矢量海报；加 download=1 以附件下载
source	限定来源，逗号分隔：xzw、tianapi、juhe、local
fresh	1 = 跳过缓存，重新获取

返回字段（format=json）

字段	说明
code / msg	0 表示成功
data.sign	星座信息：key、name、en、symbol、range、element、ruler、quality、keyword
data.title / period	如「今日运势」；period.label 日期文字，start / end 起止日期
data.scores	overall 综合 · love 爱情 · career 事业学业 · wealth 财富 · health 健康；每项含 stars（0-5）、percent、level（大吉 / 小吉 / 中平 / 小凶 / 大凶）
data.lucky	color 幸运色、color_hex 色值、number 幸运数字、match 速配星座、guard 提防星座（周运势）
data.indexes	health 健康指数、negotiation 商谈指数（百分比）
data.short	一句话短评
data.verdict	整合后的综合解读
data.details	各项详细解读（键同 scores）
data.opinions	各项下不同来源的说法列表 [{source, text}]
data.do / dont	宜 / 忌
data.mode	aggregated 已整合网络来源 · oracle 本地推演
data.sources	各来源获取状态 [{id, name, ok, url\|error}]

错误码