您需要在本周为特定的太阳星座和特定日期获取一个星座运势,并将其接入您的应用程序。通过本指南的结束,您将能够按日期检索今天和过去的星座运势,列出支持的星座/时间框架,并提取今天/每周/月的条目——使用Zyla API Hub上的生产就绪端点。
此API的功能及使用时机
Zyla API Hub上的星座API提供对多个时间框架内太阳星座的星座文本的程序化访问。它支持:
- 使用YYYY-MM-DD日期检索特定日期(今天或过去)的星座运势。
- 按时间框架获取每日、每周、每月和星期几的星座运势。
- 列出支持的太阳星座和时间框架,以便您的用户界面可以验证输入并避免用户错误。
常见的集成包括每日通知、聊天机器人、个人仪表板和需要确定性访问特定日期星座运势的内容小部件。
在Zyla API Hub上入门
打开Zyla API Hub上的星座API页面并订阅以获取您的API密钥。访问是基于订阅的,有配额(不是按调用付费),您可以在列表页面开始7天的试用。您将使用头部Authorization: Bearer YOUR_API_KEY发送请求。
API列表: 在星座API上开始7天试用
您还可以在Hub上浏览成千上万的其他现成API: Zyla API Hub。
您将使用的端点
1) 获取符号
检查支持的太阳星座和时间框架以验证用户输入并配置您的用户界面控件。
- 方法:GET
- URL:https://zylalabs.com/api/891/horoscope-api/2450/get-symbols
- 参数:无文档
- 认证:Authorization: Bearer YOUR_API_KEY
curl -s -X GET "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"status": 200,
"success": true,
"sunSigns": "gemini",
"timeFrames": "daily",
"Horoscope": "2026年9月2日 - 是时候送上那些解雇通知了吗?随着月亮在您第十二宫的治愈和结束中,时刻已经来临,切断与有毒情况的联系。这从来没有听起来那么简单,所以依靠那些支持您的人,无论是亲戚还是您选择的家庭成员。月亮正在与您温馨的第四宫中的水星形成支持性的三分相,这使得自我关怀在您今天的优先事项中名列前茅。考虑搬家吗?在午餐时间浏览列表,但对任何需要签名的事情要多加考虑。"
}
使用此信息填充下拉菜单并在调用其他端点之前验证值。
2) 获取星座运势
通过指定太阳星座和时间框架来检索今天、每周、每月或星期几的星座运势。
- 方法:GET
- URL:https://zylalabs.com/api/891/horoscope-api/694/get-horoscope
- 所需参数:
- sunsign(字符串):例如,gemini
- timeframe(字符串):例如,每日
- 认证:Authorization: Bearer YOUR_API_KEY
您通常会使用的字段: - sunSigns:您请求的太阳星座 - timeFrames:您请求的时间框架 - Horoscope:用于显示或处理的文本内容
3) 按日期
为特定日期(包括今天或过去的日期)检索特定太阳星座的星座运势。这是您需要“按日期的API”时的核心端点。
- 方法:GET
- URL:https://zylalabs.com/api/891/horoscope-api/3527/by-date
- 所需参数:
- sunsign(字符串):例如,gemini
- date(字符串):例如,2024-01-02(格式YYYY-MM-DD)
- 认证:Authorization: Bearer YOUR_API_KEY
您通常会使用的字段: - sunSigns:您请求的太阳星座 - date:您请求的日期(YYYY-MM-DD) - Horoscope:该日期的文本内容
按日期的Python示例
此示例调用按日期端点并打印返回的字段。将YOUR_API_KEY替换为您从列表页面获得的密钥。
import requests
API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/891/horoscope-api/3527/by-date"
params = {
"sunsign": "gemini",
"date": "2024-01-02"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
if data.get("success"):
print("太阳星座:", data.get("sunSigns"))
print("日期:", data.get("date"))
print("星座运势:", data.get("Horoscope"))
else:
print("请求未成功:", data)
节省时间的实施笔记
- 日期格式:在按日期端点传递日期时使用YYYY-MM-DD(例如,2024-01-02)。
- 输入验证:在启动时调用获取符号以填充和验证太阳星座和时间框架。这减少了因无效输入而导致的400/422类型错误。
- 缓存:如果您为许多用户提供相同的内容(例如,相同的星座和日期),请缓存响应以减少冗余调用并加快页面加载速度。
- 响应处理:在使用星座运势文本之前检查成功和状态字段。记录非成功的有效负载以进行故障排除。
- 认证:在每个请求中始终发送Authorization: Bearer YOUR_API_KEY。
- 使用模型:Zyla API使用带有配额的订阅计划(不是按调用付费)。列表页面显示当前访问选项,包括此API的7天试用。
实际用例
- 移动应用中的每日卡片:通过获取星座运势显示今天的星座运势,并让用户查看前几天的运势。
- 电子邮件摘要:构建一个摘要,包括昨天和今天的选定星座;通过按日期获取每个运势。
- 聊天机器人回退:如果用户询问“2024-01-02的双子座是什么?”,则路由到按日期并返回确切文本。
- 内容档案:存储按日期的响应,以便用户可以浏览其星座的历史条目。
- 小部件嵌入:通过获取符号预先验证星座/时间框架,然后调用按日期以获得确定性的历史记录。
通过MCP从AI代理调用API
您可以通过MCP兼容的客户端(例如Claude Code、Cursor、Windsurf)使用MCP端点调用Zyla API。在初始化工具时在查询字符串中提供您的API密钥:
代理的端点:https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
在此处了解有关MCP的更多信息: MCP。配置完成后,提示您的代理调用按日期端点,并提供所需的太阳星座和日期参数,或先获取获取符号以验证输入。
端到端流程示例
- 在应用程序启动时,调用获取符号以检索太阳星座和时间框架。将它们缓存以进行表单验证。
- 当用户请求特定日期时,调用按日期并在YYYY-MM-DD中提供太阳星座和日期。
- 如果用户请求“今天”,则调用按日期并使用今天的日期,或使用获取星座运势并设置timeframe=daily。
- 显示data.Horoscope。可选地显示请求的太阳星座和日期/时间框架,以确认上下文。
- 根据(太阳星座,日期/时间框架)键缓存结果,以减少重复调用。
安全和操作检查清单
- 安全存储YOUR_API_KEY(环境变量或您的秘密管理器)。
- 在HTTP请求上设置超时,以快速失败并优雅降级。
- 记录非200 HTTP状态和有效负载,其中成功为false以进行调试。
- 如果您预渲染页面,请批量调用并重用缓存响应,以保持在计划配额内。
参考:可复制的cURL请求
获取符号(支持的星座和时间框架):
获取星座运势(基于时间框架):
按日期(特定日期):
常见问题
按日期需要什么日期格式?
在日期参数中使用YYYY-MM-DD(例如,2024-01-02)。
我如何知道哪些太阳星座和时间框架是有效的?
调用获取符号端点以检索太阳星座和时间框架的权威列表,然后根据这些数组验证用户输入。
我可以按日期和时间框架检索今天的星座运势吗?
可以。对于特定的日历日,使用按日期并提供今天的日期。对于不指定日期的“今天”体验,使用获取星座运势并设置timeframe=daily。
认证方法是什么?
在所有端点的请求头中发送Authorization: Bearer YOUR_API_KEY。
定价是按调用付费吗?
不。Zyla API使用带有配额的订阅计划。请查看API页面以获取当前访问选项和定价。
立即启动您的“按日期”集成:打开列表,开始7天试用并获取您的密钥。 在星座API上开始7天试用。随时在 Zyla API Hub 探索更多API。