Ứng dụng hẹn hò

Cách thức hoạt động

1. Người dùng nhập ngày, giờ và nơi sinh khi đăng ký
2. Khi có lượt ghép — backend của bạn gọi /v1/synastry với dữ liệu của cả hai người
3. API trả về compatibility.score (0–100) và label (harmonious/balanced/mixed/challenging)
4. Điểm số được sử dụng như một trong những yếu tố xếp hạng

Thuật toán ghép đôi
  ├── Độ gần vị trí          (40%)
  ├── Sở thích chung         (30%)
  ├── Tương hợp chiêm tinh   (20%)  ← AstroWay API
  └── Các tín hiệu khác       (10%)

Các endpoint chính

Endpoint	Credit	Trả về
/v1/synastry	50	Cross-aspects + điểm 0–100
/v1/human-design/compatibility	100	Tương hợp HD (type + strategy)
/v1/horoscope/compatibility	50	Phân tích văn bản tương hợp

Mẫu tích hợp

// Khi ghép đôi — gọi synastry
async function getCompatibility(userA: UserProfile, userB: UserProfile) {
  const result = await astrowayClient.synastry({
    chart1: {
      date: userA.birthDate,
      time: userA.birthTime || '12:00:00', // noon default if unknown
      timezoneOffset: userA.tzOffset,
      latitude: userA.birthLat,
      longitude: userA.birthLng,
    },
    chart2: {
      date: userB.birthDate,
      time: userB.birthTime || '12:00:00',
      timezoneOffset: userB.tzOffset,
      latitude: userB.birthLat,
      longitude: userB.birthLng,
    },
  });

  return {
    score: result.compatibility.score,      // 0-100
    label: result.compatibility.label,      // "harmonious"
    harmony: result.compatibility.harmony,  // weighted sum
    tension: result.compatibility.tension,
  };
}

Mẹo

Kết quả synastry là bất biến (chỉ phụ thuộc vào ngày sinh). Hãy lưu cặp (userA_id, userB_id) → điểm vào cơ sở dữ liệu của bạn. Một lần gọi API — và bạn không cần tính toán lại nữa.

Đánh giá ngân sách

Kịch bản: 1.000 lượt ghép mới mỗi ngày

Chỉ số	Giá trị
Lượt ghép/ngày	1.000
Credit/lượt ghép	50 (synastry)
Credit/ngày	50.000
Credit/tháng	~1.500.000
Gói cước	Business ($199/tháng, 3.500.000 credit)

Kịch bản: 50 lượt ghép mỗi ngày (startup)

Chỉ số	Giá trị
Lượt ghép/ngày	50
Credit/ngày	2.500
Credit/tháng	~75.000
Gói cước	Starter ($19/tháng, 200.000 credit)

Tối ưu hóa

• Lưu cache — lưu điểm vào cơ sở dữ liệu, đừng tính lại
• Xử lý lười — chỉ tính synastry khi người dùng mở lượt ghép, không phải tất cả các cặp tiềm năng
• Tính toán theo lô khi đăng ký — tính tương hợp với top 20 lượt ghép tiềm năng ngay lập tức

Không có giờ sinh

Nếu người dùng không biết giờ — hãy truyền "time": "12:00:00" (giữa trưa). Các nhà sẽ kém chính xác hơn, nhưng vị trí hành tinh và cross-aspects vẫn đúng. Điểm tương hợp vẫn mang tính thông tin.

Đối với tương hợp HD, thời gian quan trọng hơn — hãy cân nhắc hd/sensitivity để đánh giá tác động của thời gian không chính xác.

Synastry API → Chi tiết về các endpoint tương hợp

Bắt đầu nhanh Làm quen trong 5 phút

Bảng giá Từ miễn phí đến Enterprise