# ज्योतिष ऐप्स

तू AstroWay API का इस्तेमाल करके Co-Star, Sanctuary, The Pattern, Chani या Costar Compat जैसे ऐप बना रहा है? AstroWay API से तुम्हें Solar Fire ($495) जैसे लाइसेंस की ज़रूरत नहीं पड़ेगी या फिर खुद का एफेमेरिस इंजन लिखने की ज़रूरत नहीं होगी: {siteMeta.endpoints} एंडपॉइंट (जन्म कुंडली, सिनास्ट्री, ट्रांज़िट, ह्यूमन डिज़ाइन, AI इंटरप्रिटेशन), OpenAPI 3.1 के ज़रिए टाइप किए गए क्लाइंट जनरेट करें (TS / Python SDK रोडमैप में है), Swiss Ephemeris की सटीकता वही है जो Astrodienst और Kepler में इस्तेमाल होती है।

## सामान्य आर्किटेक्चर

```
यूज़र (ब्राउज़र / मोबाइल)
     ↓
तेरा बैकएंड (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON रिस्पॉन्स → तेरे UI में रेंडर करें
```

<Aside type="caution">
कभी भी API की को API कुंजी को फ्रंटएंड कोड में न रखें। AstroWay API के कॉल्स को तेरे बैकएंड या सर्वर साइड फ़ंक्शन्स (Next.js API routes, Vercel Functions, AWS Lambda) के ज़रिए ही करें।
</Aside>

## ऐस्ट्रोलॉजी ऐप के लिए मुख्य एंडपॉइंट

### MVP (मिनिमम वायबल प्रोडक्ट)

| एंडपॉइंट | क्रेडिट | इस्तेमाल |
|---|---|---|
| `/v1/chart` | 20 | जन्म कुंडली बनाएं |
| `/v1/synastry` | 50 | दो लोगों की अनुकूलता |
| `/v1/horoscope/daily` | 20 | रोज़ाना का होरोस्कोप |

इन तीन एंडपॉइंट्स से ही तेरा ऐप जन्म कुंडली, अनुकूलता और रोज़ाना कंटेंट के साथ काम करने लगेगा।

### विस्तारित प्रोडक्ट

| एंडपॉइंट | क्रेडिट | इस्तेमाल |
|---|---|---|
| `/v1/transits` | 50 | जन्म कुंडली पर मौजूदा ट्रांज़िट |
| `/v1/solar-return` | 50 | सालाना कुंडली (सोलर रिटर्न) |
| `/v1/progressions` | 50 | सेकेंडरी प्रोग्रेशन्स |
| `/v1/interpret/natal` | 50 | जन्म कुंडली की AI व्याख्या |
| `/v1/transit-calendar` | 100 | ट्रांज़िट इवेंट्स कैलेंडर |
| `/v1/human-design` | 50 | ह्यूमन डिज़ाइन कुंडली |

### प्रीमियम फंक्शन्स

| एंडपॉइंट | क्रेडिट | इस्तेमाल |
|---|---|---|
| `/v1/rectification` | 500 | जन्म समय सुधार |
| `/v1/acg` | 50 | एस्ट्रोकार्टोग्राफी (जहाँ बेहतर रहना है) |
| `/v1/forecast-calendar` | 100 | सालाना फोरकास्ट हीटमैप |
| `/v1/group-synastry` | 100 | ग्रुप अनुकूलता |

## बजट अनुमान

### परिदृश्य: 100 DAU (डेली एक्टिव यूज़र्स)

मान लेते हैं कि औसत यूज़र रोज़ 3 एक्शन्स करता है:

| एक्शन | एंडपॉइंट | क्रेडिट | रिक्वेस्ट/डे | क्रेडिट/डे |
|---|---|---|---|---|
| कुंडली देखना | `/v1/chart` | 20 | 100 | 2,000 |
| रोज़ाना होरोस्कोप | `/v1/horoscope/daily` | 20 | 100 | 2,000 |
| अनुकूलता | `/v1/synastry` | 50 | 30 | 1,500 |
| **कुल** | | | **230** | **5,500/डे** |

**~165,000 क्रेडिट/महीना** (5,500 × 30) → **Starter ($19/महीना, 200,000 क्रेडिट)** प्लान जो 21% अतिरिक्त क्रेडिट देता है, या **Indie ($5/महीना, 50,000 क्रेडिट)** प्लान जिसमें अतिरिक्त 110K क्रेडिट के लिए ~$5 का अतिरिक्त शुल्क लगेगा।

### परिदृश्य: MVP के साथ 20 DAU

| एक्शन | क्रेडिट/डे |
|---|---|
| 20 कुंडलियाँ | 400 |
| 20 होरोस्कोप | 400 |
| 5 सिनास्ट्री | 250 |
| **कुल** | **1,050/डे** |

**~31,500 क्रेडिट/महीना** → **Indie ($5/महीना, 50,000 क्रेडिट)** प्लान।

## सुझाव

- **जन्म कुंडलियाँ कैश करें** — इनपुट कभी नहीं बदलता (जन्म तारीख नहीं बदलती), इसलिए अपने डेटाबेस में हमेशा के लिए रिजल्ट कैश कर सकते हो।
- **होरोस्कोप को दिन भर कैश करें** — रोज़ाना के होरोस्कोप एक ही रहते हैं सभी लोगों के लिए एक ही राशि वाले, एक बार जनरेट करो और सबको बाँट दो।
- **सैंडबॉक्स कुंजियाँ** (`aw_test_*`) — डेवलपमेंट के लिए, ये क्रेडिट नहीं काटतीं।
- **OpenAPI 3.1 से कोड जनरेशन** — `/v1/openapi.json` को `openapi-typescript` या `openapi-python-client` में डालो और टाइप किया हुआ क्लाइंट पाओ (रोडमैप में तैयार SDK उपलब्ध होंगे)।

<CardGrid>
  <LinkCard title="तेज़ शुरुआत →" href="/getting-started/" description="पहला रिक्वेस्ट बस 5 मिनट में" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="जन्म कुंडली API के बारे में विस्तार से" />
  <LinkCard title="टैरिफ" href="/pricing/" description="फ्री से लेकर Enterprise तक" />
</CardGrid>
