今日运势 API

按名字（不传则按 IP）生成今日运势：综合评分、等级、签文、五项运势、幸运色/数字/方位、宜忌。仅供娱乐

数据来源：本地计算（原创文案）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

今日运势（同一名字同一天结果固定，仅供娱乐）

GET /api/fortune

请求参数

  • name：名字或昵称，最多 20 个字符。以“北京时间日期 + 名字”的 SHA-256 哈希为随机种子，同一名字同一天结果相同；比较前会去掉首尾空白、合并空白、英文转小写。不传时按调用者 IP 生成，示例 小明

返回字段

  • date（string）：运势对应的北京时间日期，YYYY-MM-DD；北京时间 0 点后换新一天的运势
  • name（string|null）：传入的名字（去掉首尾空白）；未传 name、按 IP 生成时为 null（不回显 IP）
  • basis（string）：随机种子依据：name（按名字生成）或 ip（未传 name，按调用者 IP 生成）
  • score（number）：综合评分，0~100 的整数，越高越好
  • level（string）：综合等级，由 score 决定：大吉（90~100）、吉（75~89）、中吉（60~74）、小吉（45~59）、平（30~44）、小凶（0~29）
  • sign（string）：今日签文：两句七言的短诗，按 level 从对应文案中挑选（本项目原创，不是传统签文）
  • aspects（array）：分项运势，固定 5 项，依次为事业、财富、感情、健康、学业
  • aspects[].key（string）：分项标识：career（事业）、wealth（财富）、love（感情）、health（健康）、study（学业）
  • aspects[].name（string）：分项中文名：事业、财富、感情、健康、学业
  • aspects[].stars（number）：分项星级，1~5 的整数；与 score 正相关，但各项之间会有 ±1 星左右的浮动
  • aspects[].comment（string）：分项点评，一句话，按星级从对应文案中挑选
  • luckyColor（object）：幸运色
  • luckyColor.name（string）：颜色名称，如 天蓝、竹青
  • luckyColor.hex（string）：颜色的十六进制色值，#RRGGBB 格式（大写），可直接用于 CSS
  • luckyNumber（number）：幸运数字，1~9 的整数
  • luckyDirection（string）：幸运方位：正东、正南、正西、正北、东南、东北、西南、西北 之一
  • yi（array）：今日宜：3 项不重复的日常活动（字符串数组），如“早睡早起”
  • ji（array）：今日忌：3 项不重复的日常活动（字符串数组），如“熬夜”
  • notice（string）：固定提示语：结果仅供娱乐，请勿当真