八字 API › 西洋占星 API

西洋占星 API

只要傳送出生日期時間與座標，就會計算太陽到冥王星的 10 個天體、月交點、4 個軸點、宮位、相位、品位，連同 HRUM 預先寫好的解讀段落一次以 JSON 回傳。商品名稱為「占星全覽」，不使用 LLM。

回傳內容

本命盤 — 天體位置、星座、度數、宮位，軸點、相位、品位 (natal)
解讀段落 — 針對品位與相位預先寫好的段落，不另收費，一律附上 (readings)
行運（transit）、次限推運（progression） — 請求中加上 timing 時 (timing)
雙人合盤比較（synastry） — 請求中加上 partner 時，回傳兩人之間的相位與星座關係 (synastry)

需要自行選擇的值

宮制預設為 Placidus（普拉西度）宮制，可用 houseSystems 變更。行運與推運的容許度（timing.orbDegrees）因各家古典文獻數值不同而沒有預設值，傳送 timing 時必須填入。留空會回傳 400。

不提供的項目

不回傳次要品位與互容、推運軸點（推運 ASC·MC）、雙人合盤比較的宮位疊加。完整清單請見參考文件。

如果您正在使用 /natal-chart

本命盤商品（/natal-chart）已停止販售。若是新串接，請使用接收相同出生資料的 /astrology。

請求範例

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "birthTimePrecision": "exact",
  "birthLatitude": 37.5665,
  "birthLongitude": 126.978,
  "houseSystems": ["placidus", "whole_sign"]
}

驗證使用 X-Partner-Api-Key 標頭，基本網址為 https://api.hrum.ai/api/v1/partners/v1。Python、JavaScript 範例與錯誤處理請見入門指南。

回應範例（節錄）

{
  "success": true,
  "data": {
    "natal": {
      "utc": "1990-05-15T05:30:00.000Z",
      "timePrecision": "exact",
      "timeKnown": true,
      "zodiac": "tropical",
      "lang": "ko",
      "bodies": [
        { "id": "Sun", "longitude": 54.1347, "sign": "Taurus", "signKey": "tau", "signName": "황소자리", "degreeInSign": 24.1347, "speed": 0.9643, "retrograde": false, "dignities": [], "house": { "placidus": 9, "whole_sign": 9 } },
        { "id": "Moon", "longitude": 293.8244, "sign": "Capricorn", "signKey": "cap", "signName": "염소자리", "degreeInSign": 23.8244, "speed": 12.2943, "retrograde": false, "dignities": ["det"], "house": { "placidus": 4, "whole_sign": 5 } },
        …

這是上方請求的回應開頭。包含交點、軸點、宮位、相位的回應與欄位說明請見參考文件。

價格

占星全覽每次呼叫 ₩50（VAT 另計 · 含 VAT ₩55）。即使加上 timing·partner，不論宮制或是否包含次要相位，都是相同的單次價格。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

取得一次的結果請儲存起來重複使用。 再次傳送相同請求會再次計費。相同出生年月日時、相同選項的計算結果相同，因此請把第一次的回應存入資料庫（例如以請求內容的雜湊值作為鍵），之後使用儲存的值就不會產生費用。像今日運勢這類會隨日期改變的結果，請把日期也放進鍵中，只在當天重複使用。

完整價目表

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：占星全覽 API 參考文件。其他八字商品請見所有八字 API。

聯絡我們：contact@float.do · 營運：FLOAT Co., Ltd.