Düzeltilmiş API: Geliştiriciler için Doğum Zamanı Düzeltilmesi

Çoğu astroloji kullanıcısı doğum tarihini bilir, ancak kesin doğum saatini bilmez. 30 dakikalık bir fark, ascendantı 5+ derece kaydırabilir ve bu, evlerin ve аспектlerin konumunu değiştirir. Ciddi astrolojik çalışmalar için bu önemlidir.

Astrologlar tarafından kullanılan teknik, rektifikasyon olarak adlandırılır - bilinen yaşam olaylarından muhtemel doğum saatini belirleme. Geleneksel olarak bu, saatlerce el işi gerektirir. AstroWay, bunu otomatikleştiren iki algoritmik endpoint sunar.

Bu yazıda, rektifikasyonun ne zaman uygulanacağı, algoritmaların nasıl çalıştığı ve nasıl entegre edileceği anlatılmaktadır.

Rektifikasyon, doğum saatini düzeltmektir. Yaklaşık bir saatle (örneğin, “sabah” veya “yaklaşık 14:00”) başlar ve daraltır, menggunakan:

• Önemli yaşam olayları (evlilik, çocuklar, kariyer değişikliği, ölümler)
• Fiziksel özellikler (klasik astroloji, ascendant işaretini vücut tiplerine haritalar)
• Doğum anındaki gezegenlerin köşe pozisyonları

Çıktı, genellikle gerçek doğum saatinden ±5 dakika içinde kesinleştirilmiş bir doğum saati olur.

Hermes Trismegistus’a atfedilen klasik yöntem. Doğum anındaki Ay’ın pozisyonu ile doğum anındaki ascendant/descendant arasındaki bağlantıyı kullanır (~9 ay önce).

Nasıl çalışır:

1. Yaklaşık doğum tarihini al
2. Döllenme tarihleri aralığını hesapla (260-290 gün önce)
3. Her aday döllenme tarihini için, doğum anındaki Ay’ın pozisyonunun ascendant/descendant ile uyumlu olup olmadığını kontrol et
4. Uygun doğum saatleri listesini, uyumluluklarına göre sıralanmış olarak döndür

Hızlı, ancak daha az kesin. Geniş bir pencereyi daraltmak için iyi (örneğin, “sabah” → 2 saatlik pencere).

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`En iyi aday: ${result.bestTime}`);
console.log(`Güvenilirlik: ${result.confidence}`);

Birden fazla yaşam olayına dayalı algoritmik yaklaşım. Bu, ağır bir işlem (her istek için 120 s’ye kadar sürebilir).

Giriş:

• Yaklaşık doğum saati (aralık)
• Tarihleri ve türleri ile yaşam olaylarının listesi
• İsteğe bağlı: fiziksel açıklama

Algoritma:

1. Belirtilen aralık içinde aday doğum saatleri oluşturur (genellikle 1 dakikalık adımlarla)
2. Her adayın doğum haritasını hesaplar
3. Her adayın, yaşam olaylarının öngörülen astrolojik kalıplarla (ilerlemeler, direktler, transitler) ne kadar uyumlu olduğunu puanlar
4. En iyi adayları, güven düzeyleri ile birlikte döndürür

const result = await client.rectification({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '18:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
  events: [
    { date: '2015-06-20', type: 'evlilik' },
    { date: '2018-03-12', type: 'ilkÇocuk' },
    { date: '2020-09-05', type: 'kariyerDeğişikliği' },
  ],
});

console.log(`Düzeltilmiş saat: ${result.bestTime}`);
console.log(`Adaylar: ${result.candidates.length}`);

Rektifikasyon, aşağıdaki durumlar için değerlidir:

• Kullanıcıların doğum saatini bilmediği uygulamalar - premium özellik olarak rektiifikasyon sunun
• Profesyonel astroloji araçları - her müşterinin saatlerce el işini tasarruf eder
• HD-uygulamalar - İnsan Tasarımı, saatlere karşı çok duyarlıdır; rektiifikasyon kesinliği önemli ölçüde artırır
• Araştırma uygulamaları - tarihi haritaları, zaman kayıtları kesin olmayan durumlarda doğrulamak için

Değil için:

• Kullanıcı already doğum saatini ±5 dakika kesinlikte biliyorsa (hiçbir avantajı yoktur)
• Günlük burç uygulamaları gibi, zamanın kesinliğinin çıktı üzerinde etkisi olmayan uygulamalar (günlük güneş işareti bunu gerektirmez)

• Trutine: 250 kredi - ~1-2 saniye başına istek
• Tam Rektifikasyon: 500 kredi - 120 saniyeye kadar

Bu, API’deki en ağır endpointlerdir. Rektifikasyonu bir özellik olarak sunuyorsanız - buna göre fiyatlandırın: bu, daha yüksek bir abonelik planını veya tek seferlik satın almayı haklı çıkaran bir premium işlemdir.

Bütçe planlaması:

• Ayda 100 rektiifikasyon: ~50.000 kredi = Pro planı ($59) diğer çağrılar için bir miktar ekstra ile
• Ayda 1.000 rektiifikasyon: 500.000 kredi = Kurumsal plan

Rektifikasyon zaman alır. UI’niz:

• Asenkron işleme - isteği engelleme; sıraya koyun, ilerlemeyi gösterin
• İlerleme göstergesi - tam endpoint 120 s’ye kadar çalışabilir; kullanıcı geri bildirime ihtiyaç duyar
• Sonuç gösterimi - düzeltilmiş saat, güven düzeyi, yanlış olaylar varsa yeniden başlatma olanağı

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Rektifikasyon çalışıyor (bu 2 dakikaya kadar sürebilir)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Tamamlandı. Düzeltilmiş saat: ${result.bestTime} (güven ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Hata: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Uygulamanızdaki tipik rektiifikasyon akışı:

1. Kullanıcı yaklaşık doğum verilerini ve yaşam olaylarını girer
2. Uygulama önce /v1/rectification/trutine’i çağırır (ucuz, hızlı), pencereyi daraltmak için
3. Ardından /v1/rectification’i (tam) çağırır, kesinlik için daraltılmış pencere ile
4. Uygulama sonucu önbelleğe alır ve tüm gelecek hesaplamalar için düzeltilmiş saati kullanır
5. Gelecek çağrılar “yaklaşık değerden düzeltilmiş” etiketiyle işaretlenir

Bu birleşik yaklaşım, ~750 kredi tutarında bir tam döngüdür, ancak en iyi kesinliği sağlar.

Rektifikasyon asla %100 kesinlik sağlamaz. Profesyonel astrologlar bile 5-10 dakika arasında değişen değerlendirmelerde bulunabilir.

AstroWay algoritması, göreceli kesinliğe yöneliktir - pencereyi daraltır, ancak çıktı her zaman “en iyi aday” olarak konumlandırılır, garantili bir gerçek olarak değil. Kullanıcılara güven değerini her zaman gösterin ve daha iyi bilgilere sahip oldukları takdirde yeniden tanımlama olanağı sağlayın.

Algoritmalar, kalıp aramaya yöneliktir. Deneyimli bir astrolog, kodlamak zor olan bağlamı dikkate alır: “Evlilik acele miydi?” “Kariyer değişikliği gönüllü müydü?” Yüksek riskli haritalar için birleştirin:

1. Algoritmik rektiifikasyon - pencereyi daraltmak için
2. Astrolog tarafından el ile gözden geçirme - nihai düzeltme için

Uygulamanız, bunu premium danışmanlık olarak sunabilir.

• API referansı - rectification ve rectification/trutine endpointlerini bulun
• Fiyatlandırma - plana göre kredi maliyeti
• Hızlı Başlangıç - API anahtarınızı alın