Rectificatie API: correctie van geboortetijd voor ontwikkelaars

Більшість astrologie‑gebruikers kennen hun geboortedatum, maar weten de exacte tijd niet. Een verschil van 30 minuten kan de ascendant met meer dan 5 graden verschuiven – en dat verandert de huizenposities en aspecten. Voor serieuze astrologische werkzaamheden is dat belangrijk.

De techniek die astrologen hiervoor gebruiken, heet rectificatie – het herstellen van de waarschijnlijke geboortetijd op basis van bekende levensgebeurtenissen. Traditioneel kost dit uren handmatig werk. AstroWay biedt twee algoritmische endpoints die dit automatiseren.

In deze post – wanneer je rectificatie moet toepassen, hoe de algoritmes werken en hoe je het integreert in je applicatie.

Rectificatie – dit is correctie van de geboortetijd. Je begint met een geschatte tijd (bijvoorbeeld “ochtend” of “rond 14:00”) en verkleint deze, gebruikmakend van:

• Belangrijke levensgebeurtenissen (trouw, kinderen, carrière‑verandering, sterfgevallen)
• Fysieke kenmerken (klassieke astrologie koppelt de ascendant aan lichaamstypen)
• Hoek‑posities van planeten bij de geboorte

Uitkomst – een verfijnde geboortetijd, meestal binnen ±5 minuten van de werkelijke.

Klassieke methode, toegeschreven aan Hermes Trismegistus. Maakt gebruik van de verbinding tussen de maanspositie op het moment van geboorte en de ascendant / descendent op het moment van conceptie (~9 maanden eerder).

Hoe het werkt:

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

Snel, maar minder nauwkeurig. Handig om een breed venster te verkleinen (bijv. ‘ochtend’ → 2‑uur venster).

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

Algoritmische benadering gebaseerd op meerdere levensgebeurtenissen. Dit is een zware variant (tot 120 s per request).

Input:

• Geschatte geboortetijd (bereik)
• Lijst van levensgebeurtenissen met data en types
• Optioneel: fysieke beschrijving

Algoritme:

1. Genereert kandidaat‑geboortetijden binnen het bereik (meestal met een stap van 1 minuut)
2. Voor elke kandidaat berekent het de geboortehoroscoop
3. Schaalt elke kandidaat op basis van hoe de gebeurtenissen overeenkomen met de verwachte astrologische patronen (progressies, direcities, transits)
4. Retourneert top‑kandidaten met confidence‑scores

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

Rectificatie is waardevol voor:

• Applicaties met gebruikers die de tijd niet kennen: bied rectificatie aan als premium‑functie
• Professionele astrologie‑tools: bespaart uren handmatig werk per klant
• HD‑applicaties: Human Design is zeer tijdgevoelig; rectificatie verbetert de nauwkeurigheid aanzienlijk
• Onderzoeksapplicaties: valideer historische kaarten waar tijdsregistraties onnauwkeurig zijn

Niet nuttig voor:

• Applicaties waarbij de gebruiker de tijd al kent tot ±5 min (geen voordeel)
• Casual horoscoop‑applicaties waarbij tijdsprecisie geen invloed heeft op de output (de dagelijkse sun sign heeft het niet nodig)

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

Dit zijn de zwaarste endpoints in de API. Als je rectificatie als functie aanbiedt, prijs het dan passend: het is een premium‑operatie die een hoger abonnementstarief of een eenmalige aankoop rechtvaardigt.

Budgetplanning:

• 100 rectificaties per maand: ~50 000 credits = Pro‑plan ($59) met reserve voor andere calls
• 1 000 rectificaties per maand: 500 000 credits = Enterprise

Rectificatie kost tijd. UI moet:

• Asynchrone verwerking: blokkeer de request niet; plaats deze in de wachtrij, toon voortgang
• Progress‑indicator: volledige endpoint werkt tot 120 s; gebruiker heeft feedback nodig
• Resultaatweergave: de verfijnde tijd, confidence‑niveau, mogelijkheid tot herstart als gebeurtenissen onnauwkeurig zijn

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

Typische rectificatie‑flow in een applicatie:

1. Gebruiker voert geschatte geboortedata + levensgebeurtenissen in
2. Applicatie roept eerst /v1/rectification/trutine (goedkoop, snel) aan om het venster te verkleinen
3. Vervolgens roept het /v1/rectification (volledig) aan met het verfijnde venster voor nauwkeurigheid
4. Applicatie cachet het resultaat en gebruikt de verfijnde tijd voor alle toekomstige berekeningen
5. Toekomstige calls worden gemarkeerd met de tag ‘rectified from approximate’

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

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

Het AstroWay‑algoritme is gericht op relatieve nauwkeurigheid – het verkleint het venster, maar de output wordt altijd gepresenteerd als ‘beste kandidaat’, niet als een gegarandeerde waarheid. Toon altijd de confidence‑score aan gebruikers en geef de mogelijkheid om te herdefiniëren als ze betere informatie hebben.

Algoritmes zoeken patronen. Een ervaren astroloog houdt rekening met context die moeilijk te coderen is: ‘Was het huwelijk gehaast?’ ‘Was de carrière‑verandering vrijwillig?’ Voor kaarten met hoge inzetten combineer je:

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

Jouw applicatie kan dit aanbieden als premium‑consultatie.

• API reference: vind de endpoints rectification en rectification/trutine
• Tarijen: kosten in credits per plan
• Snel start: verkrijg een API‑sleutel