AstroWay/api v2.326.0 · hi
सभी सिस्टम सामान्य हैं

हम सटीकता को नियंत्रण में कैसे रखते हैं: swetest और NASA के विरुद्ध CI

किसी एस्ट्रो API की सटीकता एफ़ेमेरिस कोड के एक ही रिफ़ैक्टरिंग से आसानी से बिगड़ सकती है। हम सुरक्षा के तरीके को समझाते हैं: ऐप और API के लिए एक ही Swiss Ephemeris कोर, संदर्भ कुंडलियों पर सैकड़ों फ़्रीज़ किए गए स्नैपशॉट, और हर PR का swetest CGI, Kerykeion, Prokerala तथा NASA ग्रहण कैटलॉग के विरुद्ध ट्रायंगुलेशन।

सटीकता वह है जिसके लिए उपयोगकर्ता Astrodienst पर चुपचाप तुम्हारी जाँच करता है। यदि जन्म कुंडली एक कोणीय मिनट से भी भटक जाती है, तो शिकायत तुरंत आ जाती है। और इसमें सबसे बुरा यह है कि सटीकता को चुपचाप तोड़ना आसान है: एफेमेरिस कोड में एक रीफैक्टरिंग, और आधे एंडपॉइंट्स चुपचाप चाप के सेकंडों से भटक जाते हैं।

हम इसे कैसे होने नहीं देते हैं।

दो वातावरणों के लिए एक कोर

Section titled “दो वातावरणों के लिए एक कोर”

ग्रहों की स्थिति हमारे अपने सर्वर पर गणना की जाती है, किसी तीसरे पक्ष के API के बिना, कोणीय सेकंड की सटीकता के साथ, NASA JPL Horizons से सत्यापित। मुख्य बात यह है: हमारे एप्लिकेशन और API में एक ही कंप्यूटेशनल कोर, एक ही कोडबेस है। कोई दो कार्यान्वयन नहीं हैं जो अलग हो सकते हैं, इसलिए अलग होने के लिए कुछ भी नहीं है।

1800-2399 की मुख्य सीमा से बाहर की तारीखों के लिए, एक विश्लेषणात्मक एफेमेरिस है, जो थोड़ी कम सटीक (लगभग 0.1″) है, लेकिन सीमाओं पर कोई रुकावट नहीं है।

फ्रीज किए गए स्नैपशॉट

Section titled “फ्रीज किए गए स्नैपशॉट”

प्रत्येक गणना एंडपॉइंट में फ्रीज किए गए स्नैपशॉट का एक सेट होता है - इस बिल्ड के समय के 888 JSON-फिक्स्चर। रनर संदर्भ चार्ट पर एंडपॉइंट चलाता है और फिक्स्चर के साथ बाइट-दर-बाइट (सहिष्णुता के भीतर) तुलना करता है। ग्रहों के देशांतर में 5e-5° (0.18″) से अधिक का कोई भी विचलन परीक्षण को विफल कर देता है।

संदर्भ चार्ट को इस तरह से चुना गया है ताकि वे “सुविधाजनक” केंद्र के बजाय किनारों पर भी प्रहार करें:

  • Monroe, Diana, Einstein, Bowie - ज्ञात जन्म डेटा वाले ऐतिहासिक चार्ट
  • ध्रुवीय अक्षांश - जहाँ घर प्रणालियाँ पतित हो जाती हैं
  • भूमध्यरेखीय - जहाँ वे अलग तरह से व्यवहार करते हैं
  • दक्षिणी गोलार्ध - दर्पणता की जाँच

सीमांत मामले ठीक उन्हीं प्रतिगमन को पकड़ते हैं जो एक सामान्य कीव निवासी के चार्ट में दिखाई नहीं देते हैं।

बाहरी स्रोतों के विरुद्ध त्रिकोणीयकरण

Section titled “बाहरी स्रोतों के विरुद्ध त्रिकोणीयकरण”

स्नैपशॉट अपने आप में प्रतिगमन को पकड़ते हैं। पूर्ण सत्य की जाँच करने के लिए, प्रत्येक रिलीज़ को स्वतंत्र स्रोतों से सत्यापित किया जाता है:

किसके विरुद्धक्या जाँचता हैविचलन
NASA JPL Horizonsग्रहों की स्थिति231 में से 231 स्वीकार्य सीमा के भीतर, माध्यिका 0.052″
swetest CGI (Astrodienst)ग्रहों के देशांतर, घरों के कस्प0.000″
Kerykeion (Python, pyswisseph)स्वतंत्र ओपन-सोर्स लाइब्रेरी< 0.2″
Prokerala (sidereal Lahiri)साइडरियल स्थितियाँ8-17″, अयनमशा सूत्र का प्रणालीगत अंतर, ड्राइवर का नहीं
NASA 5-Millennium Eclipse Catalogग्रहण का समय और प्रकार< 1 मिनट

Prokerala के साथ विचलन कोई त्रुटि नहीं है: यह Lahiri सूत्र के विभिन्न कार्यान्वयन हैं, और हम इसे स्पष्ट रूप से दस्तावेजित करते हैं, न कि छिपाते हैं। Astrodienst के संदर्भ आउटपुट, swetest के साथ, इन चार्टों पर बहाव शून्य है।

एस्ट्रोकार्टोग्राफिक लाइनों को ज्यामितीय रूप से अलग से सत्यापित किया जाता है - भूमध्य रेखा पर सटीकता 1.5 किमी से बेहतर है।

प्रत्येक PR पर क्या चलता है

Section titled “प्रत्येक PR पर क्या चलता है”

सटीकता एक CI-गेट है, न कि एक बार की जाँच:

  • api-accuracy.yml - बैकएंड कोड में प्रत्येक PR पर स्नैपशॉट के पूरे सेट + त्रिकोणीयकरण को चलाता है। एक लाल परीक्षण मर्ज को ब्लॉक करता है।
  • check-eclipse-accuracy.yml - साल में एक बार NASA कैटलॉग के साथ ग्रहणों को सत्यापित करता है; सीमा से अधिक विचलन स्वचालित रूप से एक समस्या उत्पन्न करता है।

यह इंटीग्रेटर को क्या देता है

Section titled “यह इंटीग्रेटर को क्या देता है”

गारंटी सरल है: ग्रहों की स्थिति NASA JPL Horizons से सत्यापित हैं, और swetest के संदर्भ आउटपुट से 0.0013 कोणीय सेकंड (अधिकतम 0.561″, Chiron) की माध्यिका के साथ भिन्न होती हैं, और यह सीमा README में एक वादे से नहीं, बल्कि स्वचालन द्वारा संरक्षित है। यदि कभी कोई प्रतिगमन होता है, तो वह हमारे CI में गिरेगा, न कि तुम्हारे उपयोगकर्ता की शिकायत में।

इन आंकड़ों का सार्वजनिक संस्करण, विशिष्ट चार्टों के लिए विचलन की तालिका के साथ, सटीकता पृष्ठ पर उपलब्ध है।

MakSeong · AstroWay

मैं AstroWay API को बनाता हूँ: मैं आर्क-सेकंड तक सटीक ज्योतिषीय गणित को साफ़ REST में लोड करता हूँ और उसके बारे में जानकारी को लिखता हूँ जो वास्तव में महत्वपूर्ण है।

// इस पर बनाएं

आर्क-सेकंड तक सटीक पोज़िशन, बस 4 लाइनों के कोड में।

कार्ड के बिना मुफ्त कुंजी। पहले भुगतान तक 5,000 कॉल प्रति माह।

ब्लॉग से और सभी पोस्ट →

Engineering 2026-07-15

तीन आधिकारिक SDK: TypeScript, Python, PHP कच्चे curl के बजाय

कच्चा HTTP काम करता है, लेकिन टाइप किया गया क्लाइंट घंटों की बचत करता है: पथ स्वत: पूर्णता, अनुरोध और प्रतिक्रिया प्रकार, 408/409/429/5xx के लिए बनाए गए रीट्री और स्टेनलेस-स्टाइल त्रुटि श्रेणी। हम तीन आधिकारिक SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - की जांच करते हैं और यह कैसे एक ओपनएपीआई अनुबंध से उत्पन्न होते हैं।

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.

Engineering 2026-06-05

Horoscope API Tutorial: Build a Daily Horoscope Feature

Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.