AstroWay/api v2.173.1 · ja
すべてのシステムが正常です
// astrology api · POST /v1/chinese/zodiac/compatibility

中国占星の相性 API

2 つの誕生日を入力すると、12 支の幾何学に基づくスコア付きの相性が得られます。年動物は正確な立春の瞬間で解決されるため、2 月生まれは実際に属する動物に当てはまります。

Endpoint
POST /v1/chinese/zodiac/compatibility
Cost
10 credits
Latency
~60 ms
Tier
Tier 1
// 01 / What it computes

中国占星の相性 API

各日付は太陽年に解決され、太陽年は ephemeris から取得される立春の瞬間ではなく、1 月 1 日や中国の新年ではなく始まる年を取得します。その年の年は地支とその動物を与えます。スコアは 2 つの支の関係を読み取ります: 三合 (三つ組み) は、円周を均等に 4 つのセットに分けた 3 つの支のグループ、そして 六冲 (六つの衝突) は、直交する支をペアにしています。隣接する関係と中立的な関係は、両方の支の間で発生します。レスポンスは、解決された動物、数値スコア、カテゴリ、およびペアリングの意味を説明する短い注釈を返します。

// 02 / Live request

POST/v1/chinese/zodiac/compatibility

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "person1": { "date": "1990-05-15" },
    "person2": { "date": "1988-02-20" }
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
person1.date string (YYYY-MM-DD) yes First birth date. The animal comes from the solar year, which opens at Li Chun, not at New Year.
person2.date string (YYYY-MM-DD) yes Second birth date.
person1.time string (HH:MM:SS) no Only matters for a birth within a day of Li Chun, where the hour decides the year.
person1.timezoneOffset number (hours) no The UTC offset the clock was on. Used with time to place a boundary birth.
person1.solarYear number no Override the resolved year outright when you already hold it.
language string no Any of 21 codes. Adds animalName next to the English token; the English fields do not move.
// 04 / When to use it

When to use it

この API を使用するには、日付だけに基づいて高速で安価な相性信号が必要な場合に、例えばマッチメーキングフィルター、共有カード、クイズ、マーケティングウィジェット、誕生時刻を求めることによるコンバージョンコストを避けるためにオンボーディングステップなどに使用します。この API は、カタログ内の最も粗い読み取りであり、1 年の動物は 1 人の 8 つの特性の 1 つだけを知っているため、誠実にそれを認識しています。製品が実際の読み取りを必要とする場合、両方の人々のための完全な BaZi チャートを取得し、4 つの柱間の相互作用を確認します。

// 05 / Notes

Notes

スコアは、三合と六冲のcanonical教義に基づいており、手書きの意見マトリックスに基づいていないため、再現性があり、自分自身を説明することができます。誕生日が立春の 1 日以内であれば、時間と時差を渡すと、境界は秒単位で解決されます。動物の名前は 21 の言語に翻訳されますが、英語のトークンはそのまま残ります。

Try the 中国占星の相性 API

Grab a key and make your first call in under a minute.

99.9% SLA · 有料プラン · 30日間 ステータス →