API में न्यूमेरोलॉजी: एक ही मार्ग पर 5 प्रणालियाँ

न्यूमेरोलॉजी - गूढ़ स्टैक का वह हिस्सा है जिसे API आमतौर पर या तो पूरी तरह से छोड़ देते हैं, या केवल एक पाइथागोरियन ‘life path number’ तक सीमित कर देते हैं। हमने एक अलग रास्ता अपनाया है: 5 पूर्ण प्रणालियाँ, प्रत्येक में 10 कैनोनिकल गणनाएँ, एक ही पैरामीटराइज़्ड रूट के तहत।

कुल मिलाकर, यह /numerology/{system}/{calc} के तहत 50 एंडपॉइंट्स हैं, साथ ही एक अलग डेस्टिनी मैट्रिक्स भी है। नीचे बताया गया है कि यह कैसे काम करता है और क्यों एक रूट पर्याप्त है।

सभी गणनाएँ इस टेम्पलेट के तहत रहती हैं:

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

{system} - पाँच मानों में से एक है। प्रत्येक सिस्टम की अपनी “अक्षर → संख्या” मैपिंग तालिका और अपने स्वयं के रिडक्शन नियम हैं, इसलिए एक ही नाम का परिणाम स्कूल के आधार पर भिन्न होता है:

अज्ञात सिस्टम अनुमत मानों की सूची के साथ 400 INVALID_SYSTEM लौटाता है - पाइथागोरियन पर कोई मौन फ़ॉलबैक नहीं।

10 गणनाओं का वही सेट पाँचों में से किसी भी सिस्टम के लिए उपलब्ध है:

• life-path - जीवन पथ संख्या (जन्म तिथि से)
• expression - अभिव्यक्ति संख्या / भाग्य (पूरे नाम से)
• soul-urge - आत्मा की इच्छा संख्या (नाम के स्वर)
• personality - व्यक्तित्व संख्या (नाम के व्यंजन)
• birthday - जन्मदिन संख्या
• maturity - परिपक्वता संख्या (life-path + expression)
• balance - संतुलन संख्या (आद्याक्षर)
• challenge - चुनौती संख्याएँ
• pinnacles - शिखर संख्याएँ (जीवन काल)
• personal-year - व्यक्तिगत वर्ष संख्या

अधिकांश कॉलों के लिए अनुरोध का मुख्य भाग - बस नाम और तिथि:

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

personal-year अतिरिक्त रूप से year स्वीकार करता है, क्योंकि यह किसी विशिष्ट कैलेंडर वर्ष के कंपन की गणना करता है।

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

प्रतिक्रिया में न केवल संख्या होती है, बल्कि रिडक्शन की पूरी श्रृंखला और एक तैयार व्याख्या भी होती है:

{
  "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 फ़ील्ड रिडक्शन के प्रत्येक चरण (10 → 1) को दिखाता है, और isMaster 11, 22 और 33 पर चालू होता है - पाइथागोरियन स्कूल के समझौते के अनुसार उन्हें रिड्यूस नहीं किया जाता है। यह महत्वपूर्ण है यदि तुम अपना UI बना रहे हो: तुम्हें यह अनुमान लगाने की आवश्यकता नहीं है कि 29, 2 के बजाय 11 क्यों बन गया - श्रृंखला स्पष्ट रूप से दी गई है।

डेस्टिनी मैट्रिक्स (Destiny Matrix) - क्लासिक न्यूमेरोलॉजी का हिस्सा नहीं है, इसलिए यह अपने स्वयं के रूट पर रहता है:

POST /v1/destiny-matrix

यह टैरो के 22 मेजर आर्काना पर आधारित एक विधि है, जो जन्म तिथि से एक अष्टग्राम में फैलती है। यह केंद्रीय क्रॉस, पूर्वजों की रेखाओं, धन और संबंधों के क्षेत्रों की स्थिति लौटाता है - मैट्रिक्स को रेंडर करने के लिए एक तैयार संरचना। हम इसे /numerology/* से बाहर रखते हैं, क्योंकि यह एक अलग मॉडल है (आर्काना, संख्याओं का रिडक्शन नहीं)।

न्यूमेरोलॉजिकल गणनाएँ - स्ट्रिंग और तिथि पर शुद्ध अंकगणित हैं, बिना एफेमेरिड्स के। इसलिए वे नियत और सस्ते हैं: वही इनपुट हमेशा वही आउटपुट देता है, कैशिंग तुच्छ है। व्याख्याएँ (meaning) - स्थिर तालिकाएँ हैं, LLM नहीं, इसलिए उनमें न तो मतिभ्रम होता है और न ही कॉलों के बीच परिवर्तनशीलता।

यदि संख्याओं के ऊपर मुक्त पाठ की आवश्यकता है, तो यह AI के साथ एक अलग /interpret/* परत है - लेकिन मूल संख्याएँ हमेशा नियत कोर से आती हैं।

न्यूमेरोलॉजी टैरो, रून्स, जियोमेंसी और आई चिंग के साथ गूढ़ ऐड-ऑन पैकेज में शामिल है। प्रत्येक कॉल - एक निश्चित क्रेडिट लागत (गणनात्मक, AI-एंडपॉइंट नहीं, इसलिए सस्ते)। मुफ्त टियर - प्रति माह 10,000 क्रेडिट, जो बिना भुगतान के एक महीने में सैकड़ों उपयोगकर्ताओं के लिए एक पूर्ण न्यूमेरोलॉजिकल प्रोफ़ाइल इकट्ठा करने के लिए पर्याप्त है।

1. dashboard/sign-up पर कुंजी प्राप्त करें
2. अपने दर्शकों के लिए सिस्टम चुनें (पाइथागोरियन - पश्चिमी बाजार के लिए डिफ़ॉल्ट, वैदिक - भारतीय बाजार के लिए)
3. 10 कॉलों से एक प्रोफ़ाइल इकट्ठा करें या किसी विशिष्ट स्क्रीन के लिए एक-एक संख्या खींचें

फ़ील्ड्स और स्कीमा की पूरी सूची - न्यूमेरोलॉजी समूह के तहत OpenAPI-संदर्भ में।