Rectificatie API: correctie van geboortetijd voor ontwikkelaars

Astrologen lossen dit op met rectificatie — het herleiden van het waarschijnlijke geboortetijdstip aan de hand van bekende levensgebeurtenissen. Traditioneel is dit handmatig werk. AstroWay biedt twee algoritmische endpoints die dit automatiseren.

In deze post lees je wanneer je rectificatie toepast, hoe de algoritmes werken en hoe je het integreert in je eigen applicatie.

Rectificatie is het corrigeren van het geboortetijdstip. Je begint met een ruwe schatting (bijvoorbeeld “‘s ochtends” of “rond 14:00”) en verfijnt die aan de hand van:

• Belangrijke levensgebeurtenissen (huwelijk, kinderen, carrièreswitch, overlijden)
• Fysieke kenmerken (klassieke astrologie koppelt ascendanttekens aan lichaamstypes)
• Hoekposities van planeten bij de geboorte

Het resultaat is een verfijnd geboortetijdstip, meestal binnen ±5 minuten van het echte tijdstip.

Een klassieke methode, toegeschreven aan Hermes Trismegistus. Deze gebruikt de relatie tussen de Maanspositie bij de geboorte en de ascendant/descendant op het moment van conceptie (~9 maanden eerder).

Hoe het werkt:

1. Neem de ruwe geboortedatum
2. Bereken een bereik van conceptiedata (260–290 dagen eerder)
3. Voor elke kandidaat-conceptiedatum controleer je of de Maanspositie bij de geboorte overeenkomt met de ascendant/descendant op het moment van conceptie
4. Retourneer een lijst met kandidaat-geboortetijden, gesorteerd op fit

Snel, maar minder nauwkeurig. Goed om een breed venster te verkleinen (bijvoorbeeld van “‘s ochtends” naar een 2-uurvenster).

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 kandidaat: ${result.bestTime}`);
console.log(`Zekerheid: ${result.confidence}`);

Een algoritmische benadering gebaseerd op meerdere levensgebeurtenissen. Dit is de zwaardere optie (tot 120 seconden per verzoek).

Invoer:

• Ruw geboortetijdstip (bereik)
• Lijst met levensgebeurtenissen met data en types
• Optioneel: fysieke beschrijving

Algoritme:

1. Genereer kandidaat-geboortetijden binnen het bereik (meestal met stappen van 1 minuut)
2. Voor elke kandidaat bereken je de natal chart
3. Scoor elke kandidaat op basis van hoe goed de gebeurtenissen overeenkomen met voorspelde astrologische patronen (progressies, directies, transits)
4. Retourneer de top-kandidaten met zekerheidsscores

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: 'marriage' },
    { date: '2018-03-12', type: 'firstChild' },
    { date: '2020-09-05', type: 'careerChange' },
  ],
});

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

Rectificatie is waardevol voor:

• Applicaties met gebruikers die hun tijdstip niet weten — bied rectificatie aan als premium-functie
• Professionele astrologietools — bespaart uren handmatig werk per klant
• HD-applicaties — Human Design is zeer gevoelig voor tijd; rectificatie verbetert de nauwkeurigheid aanzienlijk
• Onderzoeksapplicaties — valideer historische kaarten waar tijdsregistraties onnauwkeurig zijn

Niet nuttig voor:

• Applicaties waar de gebruiker het tijdstip al kent met een nauwkeurigheid van ±5 minuten (geen voordeel)
• Casual horoscoop-applicaties waar de tijdstipnauwkeurigheid geen invloed heeft op de uitkomst (een dagelijkse zonnetekenhoroscoop heeft het niet nodig)

• Trutine: 250 credits — ~1–2 seconden per verzoek
• Volledige rectificatie: 500 credits — tot 120 seconden

Dit zijn de zwaarste endpoints in de API. Als je rectificatie als functie aanbiedt, moet je dit ook prijzen: het is een premium-operatie die een hoger abonnementstarief of eenmalige aankoop rechtvaardigt.

Budgetplanning:

• 100 rectificaties per maand: ~50.000 credits = Pro-plan ($59) met ruimte voor andere calls
• 1.000 rectificaties per maand: 500.000 credits = Enterprise

Rectificatie kost tijd. De UI moet:

• Asynchrone verwerking gebruiken — blokkeer het verzoek niet; zet het in een wachtrij en toon de voortgang
• Voortgangsindicator tonen — het volledige endpoint duurt tot 120 seconden; gebruikers hebben feedback nodig
• Resultaten tonen — verfijnd tijdstip, zekerheidsscore, de mogelijkheid om opnieuw te starten als de gebeurtenissen onnauwkeurig zijn

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Bezig met rectificatie (dit kan tot 2 minuten duren)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Klaar. Verfijnd tijdstip: ${result.bestTime} (zekerheid ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Fout: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Een typische workflow voor rectificatie in je applicatie:

1. De gebruiker voert ruwe geboortedata + levensgebeurtenissen in
2. De applicatie roept eerst /v1/rectification/trutine aan (goedkoop, snel) om het venster te verkleinen
3. Daarna roept het /v1/rectification (volledig) aan met het verfijnde venster voor nauwkeurigheid
4. De applicatie cachet het resultaat en gebruikt het verfijnde tijdstip voor alle toekomstige berekeningen
5. Toekomstige calls worden gemarkeerd met “gerectificeerd van ruwe data”

Deze gecombineerde aanpak kost ~750 credits voor een volledige cyclus, maar levert de beste nauwkeurigheid.

Rectificatie geeft nooit 100% nauwkeurigheid. Zelfs professionele astrologen verschillen tot 5–10 minuten in hun schattingen.

Het AstroWay-algoritme richt zich op relatieve nauwkeurigheid — het verkleint het venster, maar de uitkomst wordt altijd gepresenteerd als “beste kandidaat”, niet als een gegarandeerde waarheid. Toon altijd de zekerheidsscore aan gebruikers en geef hen de mogelijkheid om handmatig aan te passen als ze betere informatie hebben.

Algoritmes zoeken naar patronen. Een ervaren astroloog neemt context mee die moeilijk te coderen is: “Was het huwelijk overhaast?” “Was de carrièreswitch vrijwillig?” Voor kaarten met hoge inzet kun je combineren:

1. Algoritmische rectificatie — om het venster te verkleinen
2. Handmatige beoordeling door een astroloog — voor de uiteindelijke verfijning

Je applicatie kan dit aanbieden als premium-consult.

• API-referentie — vind de endpoints rectification en rectification/trutine
• Tariefinformatie — kosten in credits per plan
• Snelle start — krijg je API-sleutel