问题一：黄历查询API提供哪些核心数据？
答：我们的API接口返回的不仅是简单的“宜忌”列表。核心数据模块包括：每日干支纪年、冲煞方位、星宿值神、五行纳音、彭祖百忌、时辰吉凶细分等。更重要的是，接口提供结构化的“宜”与“忌”事项分类（如祭祀、嫁娶、出行、动土等），并附带传统黄历中的“吉神宜趋”与“凶煞宜避”详解。这为用户进行深度择日分析提供了完整的底层数据支持。
问题二：如何获取API的调用权限和密钥？
答：首先，您需要访问我们的官方网站，在“开发者中心”完成账户注册与实名认证。登录后，在控制面板中创建新应用，系统将自动生成唯一的API Key与Secret。为确保安全，密钥类似于您的数字身份凭证，请务必妥善保管，切勿在前端代码或公开场合泄露。我们建议将调用部署在服务端，并使用环境变量存储密钥信息。
问题三：API的请求频率和调用次数是否有限制？
答：是的，为确保服务稳定，我们设有分级调用限制。免费试用套餐通常允许每日100-200次低频调用，适用于初期测试。正式商业套餐则根据您的付费等级，提供从每日万次到无限制调用的多种选择。如果您预见到短期内会有爆发性调用需求（例如大型促销活动），可以提前联系客服团队，申请临时扩容服务以避免请求被限流。
问题四：接口返回的数据格式是什么？如何解析？
答：接口默认返回业界通用的JSON格式数据，结构清晰且易于解析。一个完整的响应通常包含状态码（code）、消息（msg）和数据体（data）。数据体内以键值对形式详细列出了日期对应的所有黄历信息。您可以使用任何编程语言（如Python的json模块、JavaScript的JSON.parse）来解析数据。官网提供了完整的响应字段说明文档和多种语言的代码示例，助您快速完成集成。
问题五：如何查询特定日期（如生日、纪念日）的详细黄历信息？
答：查询特定日期非常简便。在API请求中，您需要构建一个包含日期参数的HTTP请求。日期参数必须严格按照“YYYY-MM-DD”格式（例如：2023-10-01）传递。将此参数与您的API密钥一同发送至我们的接口端点。系统将精准返回该公历日期对应的农历日期、干支、宜忌等全部详细信息。请注意，我们支持查询从1900年至2100年间的广泛日期范围。
问题六：接口是否支持时辰级别（每小时）的吉凶查询？
答：是的，这是我们的特色功能之一。除了日级别的黄历，您可以通过调用“时辰吉凶”专用接口，或使用高级套餐中的完整数据接口，获取一天中12个时辰（每个时辰对应现代2小时）的详细吉凶信息。返回数据会标明每个时辰的干支、星神、以及“吉”、“凶”、“平”等定性判断，这对于需要精确到小时的传统仪式（如开工、签约、迎亲）安排至关重要。
问题七：遇到“返回数据不准确”或“与纸质黄历有出入”时怎么办？
答：此类情况可能源于历法换算或流派差异。首先，请核对您查询的日期和时区（我们默认采用北京时间，即东八区）。其次，中国传统择日学存在不同流派（如“天星派”、“斗首派”），各派别对神煞的推算规则略有不同。我们的数据综合了主流权威历书《协纪辩方书》等典籍。如您仍有疑问，可将具体日期和对比差异通过工单系统提交，我们的历法专家团队会为您提供详细的溯源和解释。
问题八：API调用失败，常见的错误码（如401，403，500）如何排查？
答：调用失败请首先查看返回的错误码：
- 401：身份验证失败。请确认API Key和Secret填写正确，且未遗漏必要的签名步骤。
- 403：权限不足。检查您的套餐是否过期，或当前调用次数是否已超限额。
- 404：请求的接口地址或日期参数可能错误，请核对文档中的URL和日期格式。
- 429：短时间内请求过于频繁，请降低调用频率或升级套餐。
- 500：服务器内部错误。这通常是我们服务端的问题，请稍后重试或联系技术支持。
问题九：能否将API集成到微信小程序或APP中？是否有SDK支持？
答：完全可以。我们的API基于标准的HTTPS协议，可无缝集成到微信小程序、安卓或iOS应用程序中。对于主流编程语言和平台，我们提供了丰富的SDK工具包（如Java、PHP、Python、Node.js等），封装了签名生成和请求过程，能极大降低您的集成开发难度。集成时，请务必遵循小程序和各大应用商店关于数据调用的安全规范，将敏感信息存储在服务器端。
问题十：数据服务是否稳定？如何保障高可用性和低延迟？
答：我们通过多层架构保障服务的稳定性与速度：
1. 负载均衡：请求通过智能DNS和负载均衡器分发至多台服务器，避免单点故障。
2. 数据缓存：热点日期数据经过预计算并缓存在内存与CDN边缘节点，确保毫秒级响应。
3. 分布式架构：计算节点与数据库采用分布式集群，任何单机故障都不会影响整体服务。
4. SLA保障：付费企业用户可享受99.9%可用性的服务等级协议保障。您可以通过开发者后台的监控面板实时查看接口状态与历史可用率。