API Rectification: sửa thời gian sinh cho nhà phát triển

Rectification là việc điều chỉnh thời gian sinh. Bạn bắt đầu với một thời gian xấp xỉ (ví dụ: “sáng sớm” hoặc “khoảng 14:00”) và thu hẹp nó bằng cách sử dụng:

• Các sự kiện quan trọng trong cuộc đời (kết hôn, sinh con, thay đổi sự nghiệp, cái chết)
• Đặc điểm thể chất (chiêm tinh học cổ điển ánh xạ dấu Ascendant lên các loại cơ thể)
• Vị trí góc của các hành tinh tại thời điểm sinh

Kết quả là thời gian sinh được tinh chỉnh, thường trong phạm vi ±5 phút so với thời gian thực.

Phương pháp cổ điển được cho là của Hermes Trismegistus. Sử dụng mối liên kết giữa vị trí của Mặt Trăng tại thời điểm sinh và Ascendant/Descendant tại thời điểm thụ tinh (~9 tháng trước).

Cách hoạt động:

1. Lấy ngày sinh xấp xỉ
2. Tính toán phạm vi ngày thụ tinh (260–290 ngày trước)
3. Đối với mỗi ngày thụ tinh ứng viên, chúng tôi kiểm tra xem vị trí Mặt Trăng tại thời điểm sinh có khớp với Ascendant/Descendant tại thời điểm thụ tinh không
4. Trả về danh sách thời gian sinh ứng viên, được sắp xếp theo mức độ phù hợp

Nhanh nhưng ít chính xác hơn. Tốt để thu hẹp một cửa sổ rộng (ví dụ: “sáng sớm” → cửa sổ 2 giờ).

const result = await client.rectification.trutine({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Suggested ascendant: ${result.suggestedAsc.toFixed(2)}°`);
console.log(`Moon above the horizon at conception: ${result.moonAboveHorizon}`);

Cách tiếp cận thuật toán dựa trên nhiều sự kiện cuộc đời. Đây là phương pháp nặng (tới 120 giây trên mỗi yêu cầu).

Đầu vào:

• Thời gian sinh xấp xỉ (phạm vi)
• Danh sách sự kiện cuộc đời với ngày và loại
• Tùy chọn: mô tả thể chất

Thuật toán:

1. Tạo các ứng viên thời gian sinh trong phạm vi (thường với bước 1 phút)
2. Đối với mỗi ứng viên, tính toán bản đồ sinh
3. Đánh giá mỗi ứng viên dựa trên mức độ các sự kiện khớp với các mẫu chiêm tinh dự đoán (progressions, directions, transits)
4. Trả về các ứng viên hàng đầu với điểm tin cậy

const result = await client.rectification.compute({
  baseInput: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  },
  events: [
    // type picks which significators are checked; weight is 1-3 importance
    { date: '2015-06-20', type: 'marriage', description: 'married', weight: 3 },
    { date: '2018-03-12', type: 'child', description: 'first child', weight: 2 },
    { date: '2020-09-05', type: 'career', description: 'career change', weight: 2 },
  ],
  searchRangeMinutes: 120,
  stepMinutes: 5,
});

const best = result.candidates[0];
console.log(`Best candidate: ${best.timeFormatted}, score ${best.score.toFixed(2)}, ${result.count} candidates scored`);
console.log(`Candidates: ${result.candidates.length}`);

Rectification có giá trị cho:

• Ứng dụng với người dùng không biết thời gian: cung cấp rectification như một tính năng premium
• Công cụ chuyên nghiệp của nhà chiêm tinh: tiết kiệm hàng giờ làm việc thủ công cho mỗi khách hàng
• Ứng dụng HD: Human Design rất nhạy cảm với thời gian; rectification cải thiện đáng kể độ chính xác
• Ứng dụng nghiên cứu: xác thực các bản đồ lịch sử nơi ghi chép thời gian không chính xác

Không hữu ích cho:

• Ứng dụng mà người dùng đã biết thời gian với độ chính xác ±5 phút (không có lợi ích)
• Ứng dụng chiêm tinh giải trí, nơi độ chính xác thời gian không ảnh hưởng đến đầu ra (daily sun sign không cần nó)

• Trutine: 250 credits: ~1–2 giây trên mỗi yêu cầu
• Full rectification: 500 credits: tới 120 giây

Đây là các endpoint nặng nhất trong API. Nếu bạn cung cấp rectification như một tính năng - hãy định giá tương ứng: đây là một hoạt động premium, biện minh cho mức giá đăng ký cao hơn hoặc mua lần một.

Lập ngân sách:

• 100 rectification mỗi tháng: ~50,000 credits = gói Pro ($59) với dư dả cho các cuộc gọi khác
• 1,000 rectification mỗi tháng: 500,000 credits = Enterprise

Rectification tốn thời gian. UI cần có:

• Xử lý bất đồng bộ: không chặn yêu cầu; đặt nó vào hàng đợi, hiển thị tiến độ
• Chỉ báo tiến độ: endpoint đầy đủ hoạt động tới 120 giây; người dùng cần phản hồi
• Hiển thị kết quả: thời gian được tinh chỉnh, mức độ tin cậy, khả năng khởi động lại nếu sự kiện không chính xác

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Running rectification (this may take up to 2 minutes)...');

  try {
    const result = await client.rectification.compute(input);
    setResult(result);
    const best = result.candidates[0];
    setStatus(`Done. Refined time: ${best.timeFormatted} (score ${best.score.toFixed(2)} of ${result.count})`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Luồng rectification điển hình trong ứng dụng:

1. Người dùng nhập dữ liệu sinh xấp xỉ + các sự kiện cuộc đời
2. Ứng dụng trước tiên gọi /v1/rectification/trutine (rẻ, nhanh) để thu hẹp cửa sổ
3. Sau đó gọi /v1/rectification (đầy đủ) với cửa sổ được tinh chỉnh để tăng độ chính xác
4. Ứng dụng lưu kết quả và sử dụng thời gian được tinh chỉnh cho tất cả các tính toán trong tương lai
5. Các cuộc gọi trong tương lai được đánh dấu là “rectified from approximate”

Cách tiếp cận kết hợp này - ~750 credits cho chu kỳ đầy đủ, nhưng mang lại độ chính xác tốt nhất.

Rectification không bao giờ cho độ chính xác 100%. Ngay cả các nhà chiêm tinh chuyên nghiệp cũng có sự chênh lệch trong đánh giá 5–10 phút.

Thuật toán AstroWay tập trung vào độ chính xác tương đối - thu hẹp cửa sổ, nhưng đầu ra luôn được định vị là “ứng viên tốt nhất”, không phải là sự thật được đảm bảo. Luôn hiển thị điểm tin cậy cho người dùng và cho phép họ xác định lại nếu họ có thông tin tốt hơn.

Thuật toán là tìm kiếm các mẫu. Nhà chiêm tinh giàu kinh nghiệm xem xét ngữ cảnh, khó mã hóa: “Liệu cuộc hôn nhân có vội vàng?” “Liệu sự thay đổi sự nghiệp là tự nguyện?” Đối với các bản đồ có rủi ro cao, hãy kết hợp:

1. Rectification thuật toán: để thu hẹp cửa sổ
2. Xem xét thủ công bởi nhà chiêm tinh: để tinh chỉnh cuối cùng

Ứng dụng của bạn có thể cung cấp điều này như một buổi tư vấn premium.

• API reference: tìm các endpoint rectification và rectification/trutine
• Pricing: chi phí bằng credits theo gói
• Quick start: nhận API key