幸运物品API文档
接口说明
幸运物品API根据出生日期和目标日期,计算个人的幸运色彩、幸运花朵、幸运食物、幸运数字和幸运宝石,帮助用户增强运势。
基本信息
| Base URL |
https://chart.12sign.top |
| 请求URL |
https://chart.12sign.top/calculate_luck |
| 请求方式 |
POST |
| Content-Type |
application/json |
请求参数
| 参数名 |
类型 |
必填 |
说明 |
| birth_year |
String |
是 |
出生年份,例如:"1990" |
| birth_month |
String |
是 |
出生月份,例如:"01" |
| birth_day |
String |
是 |
出生日期,例如:"15" |
| target_year |
String |
是 |
目标年份,例如:"2025" |
| target_month |
String |
是 |
目标月份,例如:"06" |
| target_day |
String |
是 |
目标日期,例如:"27" |
请求示例
{
"birth_year": "1949",
"birth_month": "06",
"birth_day": "22",
"target_year": "2025",
"target_month": "06",
"target_day": "27"
}
返回参数
| 参数名 |
类型 |
说明 |
| code |
Number |
状态码,0表示成功 |
| message |
String |
状态信息 |
| data |
Object |
返回的数据对象 |
| data.lucky_color |
String |
幸运色彩 |
| data.lucky_flower |
String |
幸运花朵 |
| data.lucky_food |
String |
幸运食物 |
| data.lucky_number |
Number |
幸运数字 |
| data.lucky_stone |
String |
幸运宝石 |
返回示例
{
"code": 0,
"data": {
"lucky_color": "苹果绿",
"lucky_flower": "报春花",
"lucky_food": "胡萝卜",
"lucky_number": 6,
"lucky_stone": "蛋白石"
},
"message": "success"
}
使用说明
注意事项:
- 所有日期参数均为字符串类型
- 月份和日期建议使用两位数格式,如"01"、"06"
- 目标日期通常为当前日期或近期的未来日期
- 每次查询都会根据出生信息和目标日期的组合计算出特定的幸运物品
错误代码
| 错误代码 |
说明 |
解决方案 |
| -1 |
参数错误 |
检查请求参数格式是否正确 |
| -2 |
日期格式无效 |
确保日期参数格式正确 |
| -3 |
服务器内部错误 |
请联系客服支持 |
应用场景
- 日常运势增强 - 用户可以根据API返回的幸运物品来增强日常运势
- 重要日期决策 - 在面试、考试、签约等重要日子,参考幸运物品进行着装和准备
- 礼物选择指南 - 为亲友选择礼物时的参考依据
- 个性化装饰建议 - 为用户的家居、办公环境提供个性化的装饰建议
- 心理安慰剂效应 - 提供积极的心理暗示,增强自信