您需要交付一个JavaScript集成，返回每日、每周或特定日期的星座，而无需与分散的来源或自定义抓取工具作斗争。在本指南结束时，您将能够从JavaScript查询Zyla API Hub上的星座API，解析其JSON，并自信地将其插入到您的用户界面或工作流程中。
您可以使用星座API构建的内容
星座API为多个时间框架内支持的太阳星座提供文本星座。您可以：
- 获取特定太阳星座的今日星座。
- 检索每周或每月的星座，或按星期几的变体。
- 获取特定日期或历史内容的太阳星座。
- 检查可用的太阳星座和时间框架。
常见用例包括生活方式应用中的入职流程、内容网站上的小部件、基于用户太阳星座的CRM提示，以及丰富用户会话的新鲜星座文本的聊天助手提示。
在Zyla API Hub上开始
Zyla API Hub将超过10,000个公共API集中在一个帐户、一个API密钥和一个单一的订阅模型下。要开始：
- 打开Zyla上的星座API页面。
- 点击订阅（或在可用时开始免费试用）。在Zyla上，第一个API通常提供7天的试用或50个请求。请查看API页面以获取当前访问选项和定价。生产使用没有免费计划。
- 复制您的API密钥，并使用下面显示的Authorization头。
每次调用的身份验证格式：Authorization: Bearer YOUR_API_KEY
您将使用的端点
星座API在Zyla Hub上公开三个HTTP GET端点。所有请求都需要Authorization头。如果下面没有列出某个参数，请不要包含它。
1）获取星座
检索给定太阳星座和时间框架的今日、每周、每月或按星期几的星座。
- 方法：GET
- URL：https://zylalabs.com/api/891/horoscope-api/694/get-horoscope
- 所需查询参数：
- sunsign（字符串）：gemini
- timeframe（字符串）：daily
- 描述：获取今日、每周、每月和任何星期几的星座。声明您想要检索的星座和星座。使用Symbols端点检查支持的时间框架和太阳星座。
官方cURL示例：
curl -s -X GET "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily" \
-H "Authorization: Bearer YOUR_API_KEY"官方JSON响应：
{
"status": 200,
"success": true,
"sunSigns": "gemini",
"timeFrames": "daily",
"Horoscope": "2026年9月2日 - 是时候送上那些解雇通知了吗？随着月亮进入您第十二宫的疗愈与结束，时刻已经来临，切断与有毒情况的联系。这从来没有听起来那么简单，所以依靠那些支持您的人，无论是亲戚还是您选择的家庭成员。月亮正在与您温馨的第四宫中的水星形成支持性的三分相，这使得自我关怀成为您今天的首要任务。考虑搬家吗？在午餐时间浏览房源，但对任何需要签名的事情要谨慎。从此负载中读取内容：
- status和success：快速检查您的集成。
- sunSigns和timeFrames：请求上下文的回声。
- Horoscope：要在您的用户界面中呈现的文本内容。
2）获取符号
检查支持的太阳星座和可用的时间框架。
- 方法：GET
- URL：https://zylalabs.com/api/891/horoscope-api/2450/get-symbols
- 请求参数：没有文档。
- 描述：返回可以传递给获取星座或按日期的太阳星座和时间框架数组。
官方cURL示例：
官方JSON响应：
3）按日期
按特定日期检索今日和过去的星座。
- 方法：GET
- URL：https://zylalabs.com/api/891/horoscope-api/3527/by-date
- 所需查询参数：
- sunsign（字符串）：gemini
- date（字符串）：2024-01-02
- 描述：当您需要特定太阳星座和日期的确定性内容时使用。
官方cURL示例：
官方JSON响应：
JavaScript集成：在10行内获取
以下示例调用获取双子座的星座，时间框架为每日。它包括最小的错误处理并提取您将呈现的字段。在运行之前，请替换YOUR_API_KEY。
// JavaScript（Node.js或现代浏览器）
// 端点：获取星座（每日双子座）
const url = "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily";
async function getDailyGemini() {
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
if (!res.ok) {
// 非2xx HTTP状态：记录或抛出
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}
const data = await res.json();
if (!data.success) {
throw new Error("API返回success=false");
}
// 每个示例可用的字段：
const sign = data.sunSigns; // "gemini"
const frame = data.timeFrames; // "daily"
const text = data.Horoscope; // 星座文本内容
return { sign, frame, text };
}
// 示例用法：
getDailyGemini()
.then(({ sign, frame, text }) => {
console.log(`[${sign} | ${frame}]`);
console.log(text);
})
.catch(err => {
console.error("星座获取失败：", err.message);
});
生产使用的注意事项
- 身份验证：始终传递Authorization: Bearer YOUR_API_KEY。请勿在客户端代码中嵌入您的密钥而不考虑暴露；如有需要，请通过您的后端代理调用。
- 缓存：每日、每周和每月的内容在大多数实现中不会在日内更改；按太阳星座/时间框架缓存响应以减少调用和延迟。根据时间框架粒度过期缓存（例如，每日缓存在您选择的滚动时间重置）。对于按日期，缓存不可变日期时无限期缓存。
- 参数：仅发送文档中记录的参数：
- 获取星座：sunsign，timeframe。
- 获取符号：无。
- 按日期：sunsign，date。
- 文本处理：星座字段是纯文本。按原样呈现或在您的用户界面中进行清理/格式化。将单引号和标点符号视为普通文本；避免双重编码HTML实体。
- 国际化：响应语言为英语，按示例。如果您本地化，请在您这边翻译。
端到端工作流程：验证输入，然后获取内容
在请求星座之前，验证输入是否与获取符号相符，以防止无效的太阳星座或不支持的时间框架。一个简单的流程：
- 在启动时调用获取符号一次，并将sunSigns/timeFrames存储在内存中。
- 根据这些数组验证用户选择。
- 使用验证的输入调用获取星座或按日期。
示例验证逻辑（伪步骤）：
- symbols.sunSigns.includes(userSign.toLowerCase())
- symbols.timeFrames.includes(userFrame.toLowerCase())
如果您支持历史读取，请将有效日期存储为ISO字符串（YYYY-MM-DD），并按示例请求的方式将其传递给按日期。
您本周可以交付的实际用例
- 入职个性化：在创建帐户时询问用户的太阳星座。存储他们的偏好，并通过获取星座在仪表板中显示每日或每周内容。
- 电子邮件或推送摘要：为所有按太阳星座分组的用户生成每日摘要。按太阳星座/时间框架缓存响应以保持调用低，然后分发通知。
- 聊天小部件和助手：当用户询问“今日双子座”时，调用获取星座，时间框架为每日，并将星座字段流入聊天。
- 历史比较：让用户选择过去的日期，并使用按日期获取旧条目，使用获取星座获取当前条目进行比较。
- 编辑模块：构建一个CMS块，在周五选择时间框架=周末，以显示相关内容，而无需手动更新。
您可以复制的cURL快速启动
获取符号（推荐的第一次调用）
获取星座（每日双子座）
按日期（2024年1月2日的双子座）
通过MCP从AI代理调用星座API
如果您在MCP兼容客户端（Claude Code、Cursor、Windsurf等）中编排提示或工具，您可以通过MCP端点将Zyla API作为工具调用。将您的代理指向：
端点：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从那里，您的代理可以使用相同的Hub路径和Authorization语义调用星座API。有关设置详细信息，请参阅MCP文档。这种方法使您的API密钥集中，并允许您的代理在多个Zyla API之间集成，而无需自定义HTTP粘合。
操作指导和注意事项
- 订阅模型：Zyla使用订阅+配额，而不是按调用计费。第一个API通常提供7天的试用或50个请求。始终检查API页面以获取当前访问选项和定价。
- 没有免费计划：对于生产，您需要一个有效的订阅。在您的代码中处理配额耗尽，并优雅降级（例如，缓存内容或中性消息）。
- 幂等性：GET调用在瞬态网络故障时安全重试。如果您实现重试，请考虑指数退避和小抖动。
- 时间框架：Symbols端点列出有效值，如每日、每周、每月和工作日。除非由获取符号列出，否则不要假设替代值（例如，“今天”或“明天”）。
- 日期格式：对于按日期，传递ISO日期字符串（YYYY-MM-DD），如所示。避免特定于区域的格式。
- 内容审核：星座字段是纯文本。如果您的应用程序有内容政策，请在您这边进行审核或过滤。
在哪里可以找到这个API和成千上万的其他API
星座API与成千上万的其他现成API一起位于Zyla，涵盖金融、数据丰富、AI、地理定位、电子商务和实用工具。一个帐户、一个密钥、一个订阅模型简化了跨您的堆栈的集成和计费。探索星座API页面，然后前往Zyla API Hub以查找可以组合到您的应用程序中的其他服务。
常见问题
我该如何进行身份验证？
在每个请求中发送头Authorization: Bearer YOUR_API_KEY到上面显示的Hub URL。
支持哪些太阳星座和时间框架？
调用获取符号。它返回太阳星座和时间框架的数组，您可以用来在调用获取星座或按日期之前验证输入。
我可以检索特定日期的星座吗？
可以。使用按日期端点，带有太阳星座和日期（YYYY-MM-DD），完全按照文档说明。
我应该如何缓存响应？
按太阳星座和时间框架缓存。每日内容可以缓存一天，每周缓存一周，每月缓存一个月。对于按日期，针对不可变的过去日期无限期缓存。
有免费计划吗？
没有免费计划。您的第一个API通常提供7天的试用或50个请求。请查看API页面以获取当前访问选项和定价。
准备在您的应用程序中实现这一点吗？创建您的Zyla帐户，获取API密钥，并在几分钟内访问上述端点。立即注册并开始构建。
