基本信息
接口名称：
今日运势
请求方法：
GET
计费类型：
免费
接口文档
# 今日运势 API 文档
基于种子（seed）的**确定性**每日运势生成器
---
## 接口说明
随机返回一条中文「今日运势」，包含运势类型、星级、简评、详解、幸运数字/颜色
---
## 请求地址
```
/api/fortune
```
---
## 请求方法
```
GET
```
---
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| seed | string | 是 | 任意字符串，相同 seed + 日期 = 相同运势（用于每日确定性） |
---
## 响应参数
| 字段名 | 类型 | 说明 |
|--------|------|------|
| date | string | 运势日期（YYYY-MM-DD） |
| seed | string | 回显请求种子 |
| fortune_type | string | 运势类型+领域（如 `中吉+财运`） |
| stars | string | 7 星制评级（例 `★★★★★★☆`） |
| brief | string | 一句话简评（含领域提示） |
| detail | string | 详细说明与建议 |
| lucky_number | int | 当日幸运数字（1-100） |
| lucky_color | string | 当日幸运颜色 |
---
## 响应示例
```json
{
"code": 200,
"message": "success",
"data": {
"date": "2025-06-25",
"seed": "123456",
"fortune_type": "中吉+财运",
"stars": "★★★★★★☆",
"brief": "小有收获，谨慎理财",
"detail": "整体不错，在财运方面，谨慎理财。",
"lucky_number": 42,
"lucky_color": "金色"
},
"trace_id": "xxxxxx"
}
```
---
## 错误码
| HTTP 状态 | 错误提示 | 含义 |
|-----------|----------|------|
| 400 | 缺少 seed 参数 | 未传或为空 |
| 500 | 系统内部错误 | 词库/配置异常 |
---
## 调用示例
| 场景 | 请求 URL |
|------|----------|
| 获取今日运势 | `https://api.logoi.cn/api/fortune?seed=yourstring` |
| 换日重新生成 | 修改种子或次日再请求 |
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| seed | 是 | string | 任意字符串，相同 seed + 日期 = 相同运势（用于每日确定性） |
请求示例
{
"seed": ""
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 状态码 |
返回示例
{
"code": "200"
}