Rectification API: Korrektur der Geburtszeit für Entwickler

Die meisten Astrologie-Nutzer kennen ihr Geburtsdatum, aber nicht die genaue Uhrzeit. Ein Unterschied von 30 Minuten kann den Aszendenten um 5+ Grad verschieben – und das verändert die Häuserpositionen und Aspekte. Für seriöse astrologische Arbeit ist das entscheidend.

Die Technik, mit der Astrologen das korrigieren, heißt Rektifikation – die Rekonstruktion der wahrscheinlichen Geburtszeit aus bekannten Lebensereignissen. Traditionell bedeutet das Stunden manueller Arbeit. AstroWay bietet zwei algorithmische Endpunkte, die sie automatisieren.

In diesem Post: wann du Rektifikation einsetzen solltest, wie die Algorithmen funktionieren und wie du sie in deine App integrierst.

Rektifikation ist die Korrektur der Geburtszeit. Du startest mit einer ungefähren Zeit (z. B. “morgens” oder “gegen 14:00”) und grenzt sie ein, indem du Folgendes nutzt:

• Wichtige Lebensereignisse (Heirat, Kinder, Karrierewechsel, Todesfälle)
• Körperliche Merkmale (die klassische Astrologie bildet das Aszendentenzeichen auf Körpertypen ab)
• Winkelpositionen der Planeten bei der Geburt

Das Ergebnis ist eine verfeinerte Geburtszeit, meist innerhalb von ±5 Minuten der tatsächlichen.

Klassische Methode, Hermes Trismegistos zugeschrieben. Nutzt die Beziehung zwischen der Mondposition zum Zeitpunkt der Geburt und dem Aszendenten / Deszendenten zum Zeitpunkt der Empfängnis (~9 Monate früher).

So funktioniert es:

1. Wir nehmen das ungefähre Geburtsdatum
2. Wir berechnen den Empfängniszeitraum (260–290 Tage früher)
3. Für jedes Kandidaten-Empfängnisdatum prüfen wir, ob die Mondposition bei der Geburt zum Aszendenten / Deszendenten zum Empfängniszeitpunkt passt
4. Wir geben eine Liste von Kandidaten-Geburtszeiten zurück, sortiert nach Fit

Schnell, aber weniger präzise. Gut, um ein breites Fenster einzugrenzen (z. B. “morgens” → 2-Stunden-Fenster).

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

Algorithmischer Ansatz auf Basis mehrerer Lebensereignisse. Das ist die schwere Variante (bis zu 120 s pro Anfrage).

Eingabe:

• Ungefähre Geburtszeit (Bereich)
• Liste von Lebensereignissen mit Daten und Typen
• Optional: körperliche Beschreibung

Der Algorithmus:

1. Generiert Kandidaten-Geburtszeiten innerhalb des Bereichs (meist in 1-Minuten-Schritten)
2. Berechnet für jeden Kandidaten das Geburtshoroskop
3. Bewertet jeden danach, wie gut die Ereignisse mit den vorhergesagten astrologischen Mustern übereinstimmen (Progressionen, Direktionen, Transite)
4. Gibt die Top-Kandidaten mit Konfidenzwerten zurück

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

Rektifikation ist wertvoll für:

• Apps mit Nutzern, die ihre Zeit nicht kennen: biete Rektifikation als Premium-Feature an
• Professionelle Astrologen-Tools: spart Stunden manueller Arbeit pro Klient
• HD-Apps: Human Design ist sehr zeitempfindlich; Rektifikation verbessert die Genauigkeit deutlich
• Forschungs-Apps: historische Horoskope validieren, bei denen Zeitaufzeichnungen ungenau sind

Nicht nützlich für:

• Apps, in denen der Nutzer die Zeit bereits auf ±5 Min genau kennt (kein Mehrwert)
• Casual-Horoskop-Apps, bei denen Zeitgenauigkeit die Ausgabe nicht beeinflusst (das tägliche Sun Sign braucht sie nicht)

• Trutine: 250 Credits: ~1–2 Sekunden pro Anfrage
• Vollständige Rektifikation: 500 Credits: bis zu 120 Sekunden

Das sind die schwersten Endpunkte in der API. Wenn du Rektifikation als Feature anbietest – bepreise sie entsprechend: Es ist eine Premium-Operation, die einen höheren Abo-Tarif oder einen Einmalkauf rechtfertigt.

Budgetplanung:

• 100 Rektifikationen pro Monat: ~50 000 Credits = Pro-Plan ($59) mit Puffer für andere Aufrufe
• 1 000 Rektifikationen pro Monat: 500 000 Credits = Enterprise

Rektifikation braucht Zeit. Dein UI sollte:

• Asynchrone Verarbeitung: blockiere die Anfrage nicht; stelle sie in eine Queue, zeige Fortschritt
• Fortschrittsanzeige: der vollständige Endpunkt läuft bis zu 120 s; der Nutzer braucht Feedback
• Ergebnisanzeige: verfeinerte Zeit, Konfidenzniveau, Möglichkeit zum Neustart, falls Ereignisse ungenau sind

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

Typischer Rektifikations-Flow in einer App:

1. Nutzer gibt ungefähre Geburtsdaten + Lebensereignisse ein
2. Die App ruft zuerst /v1/rectification/trutine auf (günstig, schnell), um das Fenster einzugrenzen
3. Dann ruft sie /v1/rectification (vollständig) mit dem verfeinerten Fenster für Präzision auf
4. Die App cached das Ergebnis und nutzt die verfeinerte Zeit für alle zukünftigen Berechnungen
5. Zukünftige Aufrufe werden mit “rectified from approximate” gekennzeichnet

Dieser kombinierte Ansatz kostet ~750 Credits pro vollem Zyklus, liefert aber die beste Genauigkeit.

Rektifikation liefert nie 100 % Genauigkeit. Selbst professionelle Astrologen liegen in ihren Schätzungen 5–10 Minuten auseinander.

Der AstroWay-Algorithmus zielt auf relative Genauigkeit ab – er grenzt das Fenster ein, aber die Ausgabe wird immer als “bester Kandidat” positioniert, nicht als garantierte Wahrheit. Zeige Nutzern immer den Confidence-Wert und gib ihnen die Möglichkeit, das Ergebnis zu überschreiben, wenn sie bessere Informationen haben.

Algorithmen sind Mustersuche. Ein erfahrener Astrologe berücksichtigt Kontext, der schwer zu kodieren ist: “War die Heirat überstürzt?” “War der Karrierewechsel freiwillig?” Für Horoskope mit hohem Einsatz kombiniere:

1. Algorithmische Rektifikation: um das Fenster einzugrenzen
2. Manuelle Prüfung durch einen Astrologen: für die finale Verfeinerung

Deine App kann das als Premium-Beratung anbieten.

• API-Referenz: finde die Endpunkte rectification und rectification/trutine
• Preise: Kosten in Credits pro Plan
• Schnellstart: hol dir deinen API-Key