Rectification API: Korrektur der Geburtszeit für Entwickler

Die meisten Astrologie-Anwender kennen ihr Geburtsdatum, aber nicht die genaue Geburtszeit. Eine Differenz von 30 Minuten kann den Aszendenten um 5+ Grad verschieben - und das ändert die Position der Häuser und Aspekte. Für ernsthafte astrologische Arbeit ist das wichtig.

Die Technik, mit der Astrologen das korrigieren, wird Rektifikation genannt - die Wiederherstellung der wahrscheinlichen Geburtszeit aus bekannten Lebensereignissen. Traditionell ist das Stundenlanges Handarbeit. AstroWay bietet zwei algorithmische Endpunkte, die es automatisieren.

In diesem Beitrag - wann Rektifikation anzuwenden ist, wie die Algorithmen funktionieren und wie man sie in seine Anwendung integriert.

Rektifikation ist die Korrektur der Geburtszeit. Du beginnst mit einer ungefähren Zeit (z.B. “Morgen” oder “gegen 14:00”) und verfeinerst sie, indem du:

• Wichtige Lebensereignisse (Hochzeit, Kinder, Karrierewechsel, Todesfälle)
• Physische Merkmale (klassische Astrologie kartiert den Aszendententyp auf Körpertypen)
• Kutige Positionen der Planeten bei der Geburt

Als Ausgabe erhältst du eine verfeinerte Geburtszeit, normalerweise im Bereich von ±5 Minuten von der tatsächlichen.

Ein klassischer Methoden, der Hermes Trismegistos zugeschrieben wird. Er verwendet die Verbindung zwischen der Position des Mondes bei der Geburt und dem Aszendenten / Deszendenten bei der Empfängnis (~9 Monate zuvor).

Wie es funktioniert:

1. Nimm ein ungefähres Geburtsdatum
2. Berechne den Zeitraum der Empfängnis (260-290 Tage zuvor)
3. Für jeden möglichen Empfängnistag überprüfe, ob die Position des Mondes bei der Geburt dem Aszendenten / Deszendenten bei der Empfängnis entspricht
4. Gib eine Liste möglicher Geburtszeiten zurück, sortiert nach der Passgenauigkeit

Schnell, aber weniger genau. Gut für die Verfeinerung eines weiten Zeitfensters (z.B. “Morgen” → 2-stündiges Fenster).

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(`Beste Kandidatin: ${result.bestTime}`);
console.log(`Vertrauenswürdigkeit: ${result.confidence}`);

Ein algorithmischer Ansatz basierend auf mehreren Lebensereignissen. Das ist ein anspruchsvoller Vorgang (bis zu 120 s pro Anfrage).

Eingabe:

• Ungefähre Geburtszeit (Zeitfenster)
• Liste von Lebensereignissen mit Daten und Typen
• Optional: physische Beschreibung

Algorithmus:

1. Generiert mögliche Geburtszeiten innerhalb des Zeitfensters (normalerweise mit einem Schritt von 1 Minute)
2. Für jeden Kandidaten berechnet die Geburtskarte
3. Bewertet jeden, wie gut die Ereignisse mit den vorhergesagten astrologischen Mustern übereinstimmen (Progressionen, Direktionen, Transite)
4. Gibt die Top-Kandidaten mit Vertrauenswürdigkeitsbewertungen zurück

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: 'Hochzeit' },
    { date: '2018-03-12', type: 'erstes Kind' },
    { date: '2020-09-05', type: 'Karrierewechsel' },
  ],
});

console.log(`Rektifizierte Zeit: ${result.bestTime}`);
console.log(`Kandidaten: ${result.candidates.length}`);

Rektifikation ist wertvoll für:

• Anwendungen mit Benutzern, die die Zeit nicht kennen - biete Rektifikation als Premium-Funktion an
• Professionelle Astrologen-Tools - spart Stunden manueller Arbeit pro Kunde
• HD-Anwendungen - Human Design ist sehr empfindlich gegenüber der Zeit; Rektifikation verbessert die Genauigkeit erheblich
• Forschungsanwendungen - validiert historische Karten, bei denen die Zeitangaben ungenau sind

Nicht nützlich für:

• Anwendungen, bei denen der Benutzer die Zeit bereits mit einer Genauigkeit von ±5 Minuten kennt (keine Vorteile)
• Kausale Horoskop-Anwendungen, bei denen die Genauigkeit der Zeit keinen Einfluss auf die Ausgabe hat (tägliche Sonnenzeichen benötigen sie nicht)

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

Dies sind die anspruchsvollsten Endpunkte in der API. Wenn du Rektifikation als Funktion anbietest - tarifiere entsprechend: es ist ein Premium-Vorgang, der höhere Abonnement- oder Einmalzahlungen rechtfertigt.

Budgetplanung:

• 100 Rektifikationen pro Monat: ~50.000 Kredite = Pro-Plan ($59) mit Reserve für andere Anrufe
• 1.000 Rektifikationen pro Monat: 500.000 Kredite = Enterprise

Rektifikation dauert. Die Benutzeroberfläche sollte:

• Asynchrone Verarbeitung - blockiere den Anfrage nicht; stelle sie in die Warteschlange, zeige den Fortschritt
• Fortschrittsanzeige - der gesamte Endpunkt arbeitet bis zu 120 s; der Benutzer benötigt Feedback
• Anzeige der Ergebnisse - verfeinerte Zeit, Vertrauenswürdigkeitsniveau, Möglichkeit zur Neuberechnung, wenn die Ereignisse ungenau sind

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Rektifikation läuft (dies kann bis zu 2 Minuten dauern)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Fertig. Verfeinerte Zeit: ${result.bestTime} (Vertrauenswürdigkeit ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Fehler: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Typischer Rektifikations-Fluss in einer Anwendung:

1. Der Benutzer gibt ungefähre Geburtsdaten + Lebensereignisse ein
2. Die Anwendung ruft zunächst /v1/rectification/trutine (billig, schnell) auf, um das Zeitfenster zu verfeinern
3. Dann ruft sie /v1/rectification (vollständig) mit dem verfeinerten Zeitfenster für die Genauigkeit auf
4. Die Anwendung speichert das Ergebnis und verwendet die verfeinerte Zeit für alle zukünftigen Berechnungen
5. Zukünftige Anrufe werden mit dem Label “rektifiziert von ungefähr” gekennzeichnet

Ein solcher kombinierter Ansatz - ~750 Kredite pro vollständigem Zyklus, aber bietet die beste Genauigkeit.

Rektifikation bietet niemals 100% Genauigkeit. Selbst professionelle Astrologen stimmen in ihren Bewertungen um 5-10 Minuten nicht überein.

Der AstroWay-Algorithmus ist auf relative Genauigkeit ausgerichtet - verfeinert das Zeitfenster, aber die Ausgabe wird immer als “beste Kandidatin” positioniert, nicht als garantierte Wahrheit. Zeige den Benutzern immer die Vertrauenswürdigkeitsbewertung und gib ihnen die Möglichkeit, neu zu berechnen, wenn sie bessere Informationen haben.

Algorithmen sind Mustererkennung. Ein erfahrener Astrologe berücksichtigt den Kontext, der schwer zu kodifizieren ist: “War die Hochzeit überhastet?” “War der Karrierewechsel freiwillig?” Für Karten mit hohen Einsätzen kombinieren:

1. Algorithmische Rektifikation - um das Zeitfenster zu verfeinern
2. Manuelle Überprüfung durch einen Astrologen - für die endgültige Verfeinerung

Deine Anwendung kann dies als Premium-Beratung anbieten.

• API-Referenz - finde die Endpunkte rectification und rectification/trutine
• Tarife - Kosten in Krediten pro Plan
• Schnellstart - erhält einen API-Schlüssel