Numerologi dalam API: 5 sistem perhitungan dalam satu rute

Numerologi adalah bagian dari tumpukan esoteris yang biasanya dilewatkan sepenuhnya oleh API, atau direduksi menjadi satu ‘life path number’ Pythagoras. Kami mengambil jalur yang berbeda: 5 sistem lengkap, masing-masing dengan 10 perhitungan kanonik, melalui satu rute berparameter.

Secara total, ini adalah 50 endpoint di bawah /numerology/{system}/{calc}, ditambah Matriks Takdir yang terpisah. Di bawah ini adalah cara kerjanya dan mengapa satu rute sudah cukup.

Semua perhitungan berada di bawah pola:

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

{system} adalah salah satu dari lima nilai. Setiap sistem memiliki tabel korespondensi ‘huruf → angka’ sendiri dan aturan reduksi sendiri, sehingga hasil untuk nama yang sama akan berbeda tergantung pada sekolahnya:

Sistem yang tidak dikenal akan mengembalikan 400 INVALID_SYSTEM dengan daftar nilai yang diizinkan – tidak ada fallback diam-diam ke Pythagoras.

Set yang sama dari 10 perhitungan tersedia untuk salah satu dari lima sistem:

• life-path - angka jalur hidup (dari tanggal lahir)
• expression - angka ekspresi / takdir (dari nama lengkap)
• soul-urge - angka jiwa (vokal nama)
• personality - angka kepribadian (konsonan nama)
• birthday - angka hari lahir
• maturity - angka kematangan (life-path + expression)
• balance - angka keseimbangan (inisial)
• challenge - angka tantangan
• pinnacles - angka puncak (periode hidup)
• personal-year - angka tahun pribadi

Body permintaan untuk sebagian besar panggilan hanyalah nama dan tanggal:

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

personal-year juga menerima year, karena menghitung vibrasi tahun kalender tertentu.

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"}'

Respons tidak hanya berisi angka, tetapi juga rantai reduksi lengkap dan interpretasi yang siap pakai:

{
  "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"
      }
    }
  }
}

Bidang steps menunjukkan setiap langkah reduksi (10 → 1), dan isMaster diaktifkan untuk 11, 22, dan 33 – angka-angka ini tidak direduksi sesuai kesepakatan sekolah Pythagoras. Ini penting jika kamu membangun UI sendiri: kamu tidak perlu menebak mengapa 29 menjadi 11 dan bukan 2 – rantai tersebut diberikan secara eksplisit.

Matriks Takdir (Destiny Matrix) bukan bagian dari numerologi klasik, oleh karena itu ia berada di rutenya sendiri:

POST /v1/destiny-matrix

Ini adalah metode berdasarkan 22 arcanum mayor Tarot, yang diuraikan menjadi oktagram dari tanggal lahir. Mengembalikan posisi salib tengah, garis leluhur, zona uang, dan hubungan – struktur siap pakai untuk merender matriks. Kami menyimpannya di luar /numerology/* karena ini adalah model yang berbeda (arcanum, bukan reduksi angka).

Perhitungan numerologi adalah aritmetika murni pada string dan tanggal, tanpa efemeris. Oleh karena itu, mereka deterministik dan murah: input yang sama selalu menghasilkan output yang sama, dan caching sangat mudah. Interpretasi (meaning) adalah tabel statis, bukan LLM, sehingga tidak ada halusinasi atau variabilitas antar panggilan.

Jika kamu membutuhkan teks bebas di atas angka, itu adalah lapisan terpisah /interpret/* dengan AI – tetapi angka dasar selalu berasal dari inti deterministik.

Numerologi termasuk dalam paket add-on esoteris bersama dengan Tarot, Rune, Geomansi, dan I Ching. Setiap panggilan memiliki biaya kredit tetap (endpoint perhitungan, bukan AI, jadi murah). Paket gratis adalah 10.000 kredit per bulan, yang cukup untuk mengumpulkan profil numerologi lengkap untuk beberapa ratus pengguna dalam sebulan tanpa biaya.

1. Dapatkan kunci di dashboard/sign-up
2. Pilih sistem yang sesuai untuk audiens kamu (Pythagoras adalah default untuk pasar Barat, Veda untuk pasar India)
3. Kumpulkan profil dari 10 panggilan atau tarik satu per satu angka untuk layar tertentu

Daftar lengkap bidang dan skema ada di referensi OpenAPI di bawah grup Numerology.