API Rektifikasi: Koreksi Waktu Kelahiran untuk Pengembang

Sebagian besar pengguna astrologi mengetahui tanggal lahir mereka, tetapi tidak mengetahui waktu yang tepat. Perbedaan 30 menit dapat menggeser ascendant sebesar 5+ derajat - dan ini mengubah posisi rumah dan aspek. Untuk pekerjaan astrologi yang serius, ini sangat penting.

Teknik yang digunakan oleh ahli astrologi untuk memperbaiki ini disebut rektilikasi - pemulihan waktu kelahiran yang mungkin berdasarkan peristiwa hidup yang diketahui. Secara tradisional, ini memerlukan jam-jam kerja manual. AstroWay menyediakan dua endpoint algoritmik yang mengautomatisasi proses ini.

Dalam posting ini - kapan menggunakan rektilikasi, bagaimana algoritma bekerja, dan bagaimana mengintegrasikannya ke dalam aplikasi Anda.

Rektilikasi adalah koreksi waktu kelahiran. Anda memulai dengan waktu yang kasar (misalnya, “pagi” atau “sekitar 14:00”) dan memperbaikinya dengan menggunakan:

• Peristiwa hidup yang penting (pernikahan, anak, perubahan karir, kematian)
• Karakteristik fisik (astrologi klasik memetakan tanda ascendant ke jenis tubuh)
• Posisi sudut planet pada saat kelahiran

Hasilnya adalah waktu kelahiran yang diperbarui, 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).

Bagaimana ini bekerja:

1. Ambil tanggal kelahiran yang kasar
2. Hitung rentang tanggal pembuahan (260–290 hari sebelumnya)
3. Untuk setiap tanggal pembuahan yang memungkinkan, periksa apakah posisi Bulan pada saat kelahiran sesuai dengan ascendant/descendant pada saat pembuahan
4. Kembalikan daftar waktu kelahiran yang memungkinkan, diurutkan berdasarkan kesesuaian

Cepat, tetapi kurang akurat. Baik untuk mempersempit jendela waktu yang luas (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 berbasis beberapa peristiwa hidup. Ini adalah varian yang berat (hingga 120 detik per permintaan).

Masukan:

• Waktu kelahiran yang kasar (rentang)
• Daftar peristiwa hidup dengan tanggal dan jenis
• Opsional: deskripsi fisik

Algoritma:

1. Menghasilkan waktu kelahiran yang memungkinkan di dalam rentang (biasanya dengan langkah 1 menit)
2. Untuk setiap kandidat, menghitung carta kelahiran
3. Menilai setiap kandidat berdasarkan seberapa baik peristiwa hidup sesuai dengan pola astrologi yang diprediksi (progresi, direksi, transiti)
4. Mengembalikan kandidat terbaik dengan penilaian kepercayaan

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

Rektilikasi bernilai untuk:

• Aplikasi dengan pengguna yang tidak mengetahui waktu - tawarkan rektilikasi sebagai fitur premium
• Alat profesional astrolog - menghemat jam-jam kerja manual untuk setiap klien
• Aplikasi HD - Human Design sangat sensitif terhadap waktu; rektilikasi secara signifikan meningkatkan akurasi
• Aplikasi penelitian - memvalidasi carta sejarah, di mana catatan waktu tidak akurat

Tidak berguna untuk:

• Aplikasi di mana pengguna sudah mengetahui waktu dengan akurasi ±5 menit (tidak ada keuntungan)
• Aplikasi horoskop kasual, di mana akurasi waktu tidak mempengaruhi output (sun sign harian tidak memerlukannya)

• Trutine: 250 kredit - ~1–2 detik per permintaan
• Rektilikasi Lengkap: 500 kredit - hingga 120 detik

Ini adalah endpoint yang paling berat di API. Jika Anda menawarkan rektilikasi sebagai fitur - tarifnya sesuai: ini adalah operasi premium yang membenarkan tarif langganan yang lebih tinggi atau pembelian satu kali.

Perencanaan anggaran:

• 100 rektilikasi per bulan: ~50.000 kredit = rencana Pro ($59) dengan cadangan untuk permintaan lain
• 1.000 rektilikasi per bulan: 500.000 kredit = Enterprise

Rektilikasi membutuhkan waktu. UI harus:

• Pengolahan asinkron - jangan blok permintaan; masukkan ke dalam antrian, tampilkan kemajuan
• Indikator kemajuan - endpoint lengkap bekerja hingga 120 detik; pengguna memerlukan umpan balik
• Tampilkan hasil - waktu yang diperbarui, tingkat kepercayaan, kemungkinan untuk memulai 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 rektilikasi yang umum dalam aplikasi:

1. Pengguna memasukkan data kelahiran yang kasar + peristiwa hidup
2. Aplikasi pertama kali memanggil /v1/rectification/trutine (murah, cepat) untuk mempersempit jendela waktu
3. Kemudian memanggil /v1/rectification (lengkap) dengan jendela waktu yang diperbarui untuk akurasi
4. Aplikasi menyimpan hasil dan menggunakan waktu yang diperbarui untuk semua perhitungan di masa depan
5. Permintaan di masa depan diberi label “rektilikasi dari perkiraan”

Pendekatan gabungan seperti ini - ~750 kredit untuk siklus lengkap, tetapi memberikan akurasi terbaik.

Rektilikasi tidak pernah memberikan akurasi 100%. Bahkan ahli astrologi profesional berbeda dalam penilaian mereka sebesar 5–10 menit.

Algoritma AstroWay berfokus pada akurasi relatif - mempersempit jendela waktu, tetapi output selalu diposisikan sebagai “kandidat terbaik”, bukan sebagai kebenaran yang dijamin. Selalu tampilkan pengguna dengan penilaian kepercayaan dan berikan kemungkinan untuk memperbarui jika mereka memiliki informasi yang lebih baik.

Algoritma adalah pencarian pola. Ahli astrologi berpengalaman mempertimbangkan konteks yang sulit dikodekan: “Apakah pernikahan itu terburu-buru?” “Apakah perubahan karir itu sukarela?” Untuk carta dengan taruhan tinggi, gabungkan:

1. Rektilikasi algoritmik - untuk mempersempit jendela waktu
2. Tinjauan manual oleh ahli astrolog - untuk perbaikan akhir

Aplikasi Anda dapat menawarkan ini sebagai konsultasi premium.

• Referensi API - temukan endpoint rectification dan rectification/trutine
• Harga - biaya dalam kredit berdasarkan rencana
• Memulai Cepat - dapatkan kunci API