🌙 PowerLife 萬年曆 API

版本 1.0.0 | 提供農曆、節氣、宜忌、神煞等數據查詢服務

📖 快速開始

⚠️ 重要提示：所有 API 請求都需要在請求頭中包含 X-API-Key 進行認證。

認證方式

Headers:
X-API-Key: PowerLife-APP-2025-v1

基礎 URL

https://api.doctorfate.net

🔌 API 端點

📅 萬年曆 API

提供公曆、農曆、節氣、宜忌等萬年曆數據查詢

GET /today

功能：獲取今日的萬年曆數據

參數：無需參數

GET /query

功能：查詢指定公曆日期的萬年曆數據

year, month, day (required)

GET /range

功能：查詢指定日期範圍的萬年曆數據（最多31天）

start, end (required, YYYY-MM-DD)

GET /search

功能：按條件查詢（生肖、節氣、干支、農曆、節日）

type (required) - lunar, shengxiao, jieqi, ganzhi, holiday

⭐ 神煞 API

提供八字神煞查詢、規則匹配等功能

GET /shensha/list

功能：獲取所有啟用的神煞列表

type (optional) - 年柱、月柱、日柱、時柱

check_method (optional) - 年支、日支、日干等

GET /shensha/info

功能：查詢指定神煞的詳細信息

id or name (required) - 神煞ID或名稱

include_rules (optional) - 是否包含規則（默認1）

GET /shensha/query

功能：根據八字信息查詢對應的神煞規則

shensha_id (required) - 神煞ID

check_value or check_values (required) - 查詢值（單個或多個，用逗號分隔）

GET /shensha/search

功能：模糊搜索神煞（按關鍵字）

keyword (required) - 搜索關鍵字

limit (optional) - 返回數量限制（默認50，最大100）

⚡ 限流規則

APP 專用密鑰：
• 每分鐘：60 次
• 每小時：1000 次
• 每天：10,000 次

網站專用密鑰：
• 每分鐘：100 次
• 每小時：1000 次
• 每天：20,000 次

❌ 錯誤碼

200 - 成功

400 - 請求參數錯誤

401 - 認證失敗（API Key 無效）

404 - 資源不存在

429 - 請求過於頻繁（超出限流）

500 - 服務器內部錯誤