API Rektifikasi: Koreksi Waktu Kelahiran untuk Pengembang

Sebagian besar pengguna astrologi tahu tanggal lahir mereka, tetapi tidak tahu waktu pastinya. Selisih 30 menit bisa menggeser ascendant sebesar 5+ derajat - dan itu mengubah posisi house serta aspek. Untuk pekerjaan astrologi yang serius, ini penting.

Teknik yang digunakan astrolog untuk memperbaikinya disebut rektifikasi - memulihkan waktu lahir yang paling mungkin dari peristiwa-peristiwa kehidupan yang diketahui. Secara tradisional ini memakan waktu berjam-jam kerja manual. AstroWay menyediakan dua endpoint algoritmik yang mengotomatisasinya.

Di postingan ini - kapan menggunakan rektifikasi, bagaimana algoritmanya bekerja, dan cara mengintegrasikannya ke aplikasimu.

Rektifikasi adalah koreksi waktu lahir. Kamu mulai dari waktu perkiraan (misalnya, “pagi” atau “sekitar pukul 14:00”) dan mempersempitnya menggunakan:

• Peristiwa penting kehidupan (pernikahan, anak, perubahan karier, kematian)
• Karakteristik fisik (astrologi klasik memetakan tanda ascendant ke tipe tubuh)
• Posisi angular planet saat kelahiran

Hasilnya - waktu lahir yang diperhalus, biasanya dalam rentang ±5 menit dari waktu sebenarnya.

Metode klasik yang dikaitkan dengan Hermes Trismegistus. Menggunakan hubungan antara posisi Bulan pada saat kelahiran dan ascendant / descendant pada saat pembuahan (~9 bulan sebelumnya).

Cara kerjanya:

1. Ambil tanggal lahir perkiraan
2. Hitung rentang tanggal pembuahan (260–290 hari sebelumnya)
3. Untuk setiap tanggal pembuahan kandidat, periksa apakah posisi Bulan saat kelahiran cocok dengan ascendant / descendant pada saat pembuahan
4. Kembalikan daftar waktu lahir kandidat, diurutkan berdasarkan fit

Cepat, tetapi kurang akurat. Bagus untuk mempersempit jendela yang lebar (misalnya, “pagi” → jendela 2 jam).

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}`);

Pendekatan algoritmik berdasarkan beberapa peristiwa kehidupan. Ini varian berat (hingga 120 detik per permintaan).

Input:

• Waktu lahir perkiraan (rentang)
• Daftar peristiwa kehidupan dengan tanggal dan tipe
• Opsional: deskripsi fisik

Algoritma:

1. Menghasilkan waktu lahir kandidat di dalam rentang (biasanya dengan langkah 1 menit)
2. Untuk setiap kandidat, menghitung chart natal
3. Memberi skor pada masing-masing, seberapa cocok peristiwa dengan pola astrologi yang diprediksi (progresi, direksi, transit)
4. Mengembalikan kandidat teratas dengan skor keyakinan

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}`);

Rektifikasi berharga untuk:

• Aplikasi dengan pengguna yang tidak tahu waktu lahir: tawarkan rektifikasi sebagai fitur premium
• Alat astrolog profesional: menghemat berjam-jam kerja manual untuk setiap klien
• Aplikasi HD: Human Design sangat sensitif terhadap waktu; rektifikasi meningkatkan akurasi secara drastis
• Aplikasi riset: memvalidasi chart historis yang catatan waktunya tidak akurat

Tidak berguna untuk:

• Aplikasi di mana pengguna sudah tahu waktu dengan akurasi ±5 menit (tidak ada manfaatnya)
• Aplikasi horoskop kasual di mana akurasi waktu tidak memengaruhi output (sun sign harian tidak membutuhkannya)

• Trutine: 250 kredit: ~1–2 detik per permintaan
• Rektifikasi penuh: 500 kredit: hingga 120 detik

Ini adalah endpoint terberat di API. Jika kamu menawarkan rektifikasi sebagai fitur - tetapkan harga yang sesuai: ini operasi premium yang membenarkan tingkat langganan lebih tinggi atau pembelian satu kali.

Perencanaan anggaran:

• 100 rektifikasi per bulan: ~50 000 kredit = paket Pro ($59) dengan sisa untuk panggilan lain
• 1 000 rektifikasi per bulan: 500 000 kredit = Enterprise

Rektifikasi memakan waktu. UI harus memiliki:

• Pemrosesan asinkron: jangan blokir permintaan; masukkan ke antrean, tampilkan progres
• Indikator progres: endpoint penuh berjalan hingga 120 detik; pengguna butuh umpan balik
• Tampilan hasil: waktu yang diperhalus, tingkat keyakinan, kemungkinan menjalankan ulang jika peristiwa tidak akurat

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);
  }
}

Alur rektifikasi tipikal di aplikasi:

1. Pengguna memasukkan data lahir perkiraan + peristiwa kehidupan
2. Aplikasi pertama memanggil /v1/rectification/trutine (murah, cepat) untuk mempersempit jendela
3. Lalu memanggil /v1/rectification (penuh) dengan jendela yang diperhalus untuk akurasi
4. Aplikasi menyimpan hasil di cache dan menggunakan waktu yang diperhalus untuk semua perhitungan di masa depan
5. Panggilan di masa depan ditandai dengan label “rectified from approximate”

Pendekatan gabungan ini - ~750 kredit per siklus penuh, tetapi memberikan akurasi terbaik.

Rektifikasi tidak pernah memberikan akurasi 100%. Bahkan astrolog profesional berbeda pendapat 5–10 menit dalam perkiraan mereka.

Algoritma AstroWay berorientasi pada akurasi relatif - mempersempit jendela, tetapi output selalu diposisikan sebagai “kandidat terbaik”, bukan kebenaran yang dijamin. Selalu tampilkan skor confidence kepada pengguna dan beri kemungkinan untuk menimpa jika mereka punya informasi yang lebih baik.

Algoritma adalah pencarian pola. Astrolog berpengalaman mempertimbangkan konteks yang sulit dikodekan: “Apakah pernikahannya terburu-buru?” “Apakah perubahan karier itu sukarela?” Untuk chart dengan taruhan tinggi, kombinasikan:

1. Rektifikasi algoritmik: untuk mempersempit jendela
2. Tinjauan manual oleh astrolog: untuk penyempurnaan akhir

Aplikasimu bisa menawarkan ini sebagai konsultasi premium.

• API reference: temukan endpoint rectification dan rectification/trutine
• Tarif: biaya dalam kredit per paket
• Mulai cepat: dapatkan API key