API tương thích hoàng đạo Trung Quốc

Mỗi ngày được chuyển đổi thành năm mặt trời của nó, bắt đầu tại thời điểm Lập Xuân lấy từ lịch thiên văn thay vì vào ngày 1 tháng 1 hoặc Tết Nguyên Đán. Năm đó cung cấp nhánh địa chi và con giáp tương ứng. Điểm số sau đó đọc mối quan hệ giữa hai nhánh: tam hợp (三合), nhóm bốn bộ ba nhánh cách đều xung quanh vòng tròn, và lục xung (六冲), ghép mỗi nhánh với nhánh đối diện trực tiếp. Các mối quan hệ láng giềng và trung gian nằm ở giữa. Phản hồi trả về cả hai con giáp đã xác định, một điểm số số, một danh mục và một ghi chú ngắn giải thích ý nghĩa của sự kết hợp, để giao diện người dùng có thể hiển thị kết quả mà không cần tra cứu thêm.

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" }
  }'

{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}

Sử dụng khi bạn muốn một tín hiệu tương thích nhanh, rẻ chỉ dựa trên ngày: bộ lọc hẹn hò, một thẻ chia sẻ, một bài kiểm tra, một widget tiếp thị, một bước hướng dẫn nơi việc hỏi giờ sinh sẽ làm bạn mất khách hàng. Đây là cách đọc thô nhất trong danh mục và nó trung thực về điều đó, vì một con giáp năm chỉ biết chính xác một đặc điểm trong tám đặc điểm của một người. Khi sản phẩm đòi hỏi một cách đọc thực sự, hãy lấy biểu đồ BaZi đầy đủ cho cả hai người và xem xét tương tác qua tất cả bốn cột thay vào đó.

Điểm số được suy xuất từ học thuyết kinh điển tam hợp (三合) và lục xung (六冲), chứ không phải từ ma trận ý kiến viết tay, đó là lý do tại sao nó có thể tái tạo và tự giải thích. Một người sinh trong vòng một ngày của Lập Xuân là trường hợp duy nhất mà giờ sinh quan trọng: truyền thời gian và timezoneOffset và ranh giới được giải quyết đến từng giây. Tên con giáp được dịch sang 21 ngôn ngữ; mã tiếng Anh giữ nguyên vị trí.