API'de Numeroloji: Tek bir rotada 5 hesaplama sistemi

Nümeroloji, API’lerin genellikle tamamen atladığı veya tek bir Pisagorcu «life path number» ile sınırladığı ezoterik yığının bir parçasıdır. Biz farklı bir yol izledik: her biri 10 kanonik hesaplamaya sahip 5 tam sistem, tek bir parametreli rota altında.

Toplamda bu, /numerology/{system}/{calc} altında 50 endpoint ve ayrıca ayrı bir Kader Matrisi anlamına geliyor. Aşağıda, bunun nasıl çalıştığı ve neden tek bir rotanın yeterli olduğu açıklanmıştır.

Tüm hesaplamalar şu şablon altında yer alır:

POST /v1/numerology/{system}/{calc}

{system} - beş değerden biridir. Her sistemin kendi “harf → sayı” eşleştirme tablosu ve kendi indirgeme kuralları vardır, bu nedenle aynı isim için sonuç okula bağlı olarak farklılık gösterir:

Bilinmeyen bir sistem, izin verilen değerlerin bir listesiyle birlikte 400 INVALID_SYSTEM döndürür - Pisagorcuya sessiz bir geri dönüş (fallback) yoktur.

Aynı 10 hesaplama seti, beş sistemin herhangi biri için mevcuttur:

• life-path - yaşam yolu sayısı (doğum tarihinden)
• expression - ifade sayısı / kader (tam isimden)
• soul-urge - ruh sayısı (isimdeki sesli harfler)
• personality - kişilik sayısı (isimdeki sessiz harfler)
• birthday - doğum günü sayısı
• maturity - olgunluk sayısı (life-path + expression)
• balance - denge sayısı (baş harfler)
• challenge - meydan okuma sayıları
• pinnacles - zirve sayıları (yaşam dönemleri)
• personal-year - kişisel yıl sayısı

Çoğu çağrı için istek gövdesi - sadece isim ve tarih:

{ "name": "Ada Lovelace", "date": "1815-12-10" }

personal-year ek olarak year kabul eder, çünkü belirli bir takvim yılının titreşimini hesaplar.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace","date":"1815-12-10"}'

Yanıt sadece sayıyı değil, aynı zamanda tam indirgeme zincirini ve hazır bir yorumu da içerir:

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1815-12-10",
    "lifePath": {
      "raw": 10,
      "reduced": 1,
      "isMaster": false,
      "steps": [10, 1],
      "meaning": {
        "number": 1,
        "archetype": "The Pioneer",
        "strengths": ["leadership", "independence", "innovation", "initiative"],
        "challenges": ["ego", "impatience", "isolation", "stubbornness"],
        "career": ["entrepreneur", "executive", "inventor", "pioneer"],
        "relationship": "needs a partner who respects independence; thrives on mutual challenge",
        "shortRead": "born to lead and originate; learn to balance solo drive with collaboration"
      }
    }
  }
}

steps alanı her indirgeme adımını (10 → 1) gösterir ve isMaster 11, 22 ve 33’te açılır - Pisagor okulunun anlaşmasına göre bunlar indirgenmez. Kendi kullanıcı arayüzünü oluşturuyorsan bu önemlidir: 29’un neden 2 değil de 11 olduğunu tahmin etmene gerek kalmaz - zincir açıkça verilir.

Kader Matrisi (Destiny Matrix) klasik nümerolojinin bir parçası değildir, bu yüzden kendi rotasında yer alır:

POST /v1/destiny-matrix

Bu, doğum tarihinden itibaren bir oktagrama ayrılan 22 büyük Tarot arkanasına dayalı bir yöntemdir. Merkezi haçın, atalar çizgilerinin, para ve ilişki bölgelerinin konumlarını döndürür - matrisi oluşturmak için hazır bir yapı. Bunu /numerology/* dışında tutuyoruz, çünkü bu farklı bir modeldir (arkana, sayıların indirgenmesi değil).

Nümerolojik hesaplamalar - efemeris olmadan, bir dize ve tarih üzerinde saf aritmetiktir. Bu nedenle deterministiktirler ve ucuzdurlar: aynı girdi her zaman aynı çıktıyı verir, önbelleğe alma basittir. Yorumlar (meaning) - statik tablolardır, LLM değildir, bu nedenle ne halüsinasyonlar ne de çağrılar arasında değişkenlik içerirler.

Sayıların üzerine serbest metin gerekiyorsa, bu zaten AI ile ayrı bir /interpret/* katmanıdır - ancak temel sayılar her zaman deterministik çekirdekten gelir.

Nümeroloji, Tarot, rünler, jeomansi ve I Ching ile birlikte ezoterik eklenti paketine dahildir. Her çağrı - sabit bir kredi maliyetine sahiptir (hesaplamalı, AI endpointleri değil, bu yüzden ucuzdur). Ücretsiz plan - ayda 10.000 kredi, bu da birkaç yüz kullanıcı için tam bir nümerolojik profil oluşturmak için yeterlidir ve aylık ödeme gerektirmez.

1. dashboard/sign-up adresinden anahtar al
2. Kitlen için bir sistem seç (Pisagorcu - Batı pazarı için varsayılan, Vedik - Hint pazarı için)
3. 10 çağrıdan oluşan bir profil oluştur veya belirli bir ekran için tek tek sayıları çek

Alanların ve şemaların tam listesi - Numerology grubu altında OpenAPI referansında.