# कोड-रहित इंटीग्रेशन

इन सभी पृष्ठों पर 2026-09-17 के प्रोडक्शन के खिलाफ किया गया है। n8n के लिए वर्कफ़्लो इम्पोर्ट किया गया है और वास्तविक n8n में चलाया गया है; Zapier और Make के लिए कदम इन टूल्स की अपनी डॉक्यूमेंटेशन के अनुसार लिखे गए हैं, और जो अनुरोध वे बनाते हैं, वह बिल्कुल इस रूप में भेजे जाते हैं।

## रिक्वेस्ट कहाँ से आती है

इस पर निर्भर करता है कि तुझे कौन-सी कुंजी चाहिए।

- **Zapier, Make और n8n** इसे अपने सर्वरों से भेजते हैं। “सिर्फ सर्वर” कुंजी चाहिए जिसमें एन्डपॉइंट्स की रेंज और बजट हो, जैसा नीचे बताया गया है। निर्देश: [Zapier](/integrations/zapier/), [Make](/integrations/make/), [n8n](/integrations/n8n/).
- **Bubble** भी अपने सर्वरों से अनुरोध भेजता है, और कुंजी हेडर में रहती है, वहीँ पर: [Bubble](/integrations/bubble/).
- **FlutterFlow** कोड को ऐसे एप्लिकेशन में कंपाइल करता है जो उपयोगकर्ता रखता है, इसलिए कॉल को प्राइवेट होना चाहिए: [FlutterFlow](/integrations/flutterflow/).
- **Wix, Squarespace, Shopify, Webflow और Tilda** पेज को विज़िटर के ब्राउज़र में दिखाते हैं। कुंजी नहीं, विजेट एम्बेड करो: [साइट बिल्डर](/integrations/site-builders/).
- **WordPress** आपके अपने सर्वर से कॉल करता है। कुंजी का ध्यान [AstroWay प्लगइन](https://wordpress.org/plugins/astroway/) रखता है।

<Aside type="caution">
पब्लिक कुंजी `pk_` Zapier, Make या n8n के साथ काम नहीं करती। यह अपने लिस्ट से origin के बिना रिक्वेस्ट को रिजेक्ट कर देती है, और ये टूल्स origin नहीं भेजते। साइट पेज से यह केवल `/v1/public/*` और `/v1/embed/*` लेती है।
</Aside>

## ऑटोमेशन के लिए कुंजी

जो भी Zap, स्क्रिप्ट या वर्कफ़्लो को एडिट कर सकता है, वह अंदर कुंजी देखता है। इसलिए हर ऑटोमेशन को अपनी अलग कुंजी दो और उसे उसकी कार्यक्षमता तक सीमित रखो।

1. डैशबोर्ड में [API-कीज़](https://api.astroway.info/dashboard/keys) खोलो और **नया कुंजी** पर क्लिक करो। इसे ऑटोमेशन के नाम से नाम दो, जैसे `zapier-intake-form`.
2. फ़ील्ड **यह कुंजी कहाँ उपयोग होगी?** में **सिर्फ सर्वर** रखो.
3. कुंजी कॉपी करो। डायलॉग इसे एक बार पूरी दिखाता है; बाद में यह **दिखाएँ** मेन्यू में उपलब्ध होगा.
4. कुंजी मेन्यू में **एन्डपॉइंट रेंज** खोलो और उन पाथ्स को एक-एक लाइन में लिस्ट करो, जो ऑटोमेशन कॉल करता है: `chart` नेटल चार्ट के लिए, `public/horoscope/*` दैनिक होरोस्कोप के लिए.
5. उसी मेन्यू में **बजट सेट करो** और बताओ कि इस कुंजी से एक साइकिल में कितने क्रेडिट खर्च हो सकते हैं.

रेंज के बाहर कॉल करने पर `403 ENDPOINT_NOT_IN_SCOPE` मिलता है। बजट खत्म हो जाने वाली कुंजी को `429 KEY_BUDGET_EXHAUSTED` मिलता है, भले ही अकाउंट में अभी भी क्रेडिट हों, इसलिए लूप में फँसी ऑटोमेशन निर्दिष्ट संख्या पर रुक जाएगी। दोनों लिमिट सभी प्लान्स पर काम करते हैं और [ऑथेंटिकेशन](/authentication/) सेक्शन में वर्णित हैं।

## जन्म का समय भेजो, न कि ऑफ़सेट

फ़ॉर्म तारीख, समय और स्थान देता है। इन्हें इस तरह भेजो:

```json
{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}
```

- **`timezone`** यह ज़ोन का नाम है, और सर्वर खुद UTC से ऑफ़सेट ढूँढ लेता है, जो उस तारीख की घड़ियों में था, साथ ही डेलाइट सेविंग के साथ। कीव 1990-05-15 UTC+4 पर था, +3 नहीं: मैन्युअल ऑफ़सेट से यही गलती होती है। `auto` भेजो ताकि कोऑर्डिनेट्स से ज़ोन लिया जाए।
- **`timezone` और ऑफ़सेट बिना** चार्ट UTC के लिए गणना होता है। रिस्पॉन्स फिर भी `200` है, इसलिए जाँचो कि फ़ील्ड मैप्ड है।
- **खाली `timezone`** `400` से रिजेक्ट होता है, क्योंकि नहीं तो खाली फ़ॉर्म फ़ील्ड को UTC माना जाता।
- **`date`** फॉर्मेट `YYYY-MM-DD` में, **`time`** फॉर्मेट `HH:MM:SS` में। अगर फ़ॉर्म इसे अलग रखता है, तो टूल में डेट फ़ॉर्मेटिंग का उपयोग करो।
- **नंबर टेक्स्ट के रूप में आ सकते हैं।** `"latitude": "50.45"` स्वीकार किया जाता है, और अधिकांश फ़ॉर्म फ़ील्ड इसी तरह भेजते हैं।
- **API जियोकोड नहीं करता।** कोऑर्डिनेट्स फ़ॉर्म से या टूल में जियोकोडिंग स्टेप से आने चाहिए। फ़ील्ड `city` सिर्फ़ एक लेबल है।

1970 से पहले के टाइम और डेट कन्वर्ज़न के नियम [फ़ील्ड फ़ॉर्मैट्स](/agent-setup/field-formats/#timezone-назва-зони-замість-зсуву) में वर्णित हैं।

## लोंगिट्यूड को साइन में कैसे बदलें

`POST /v1/chart` ज़ोडियैक के साथ डिग्री में रिटर्न करता है, रैपर `{ "ok": true, "data": { ... } }` में। साइन `floor(longitude / 30)` से मिलता है, शून्य से गिनते हुए:

0 मेष, 1 वृषभ, 2 मिथुन, 3 कर्क, 4 सिंह, 5 कन्या, 6 तुला, 7 वृश्चिक, 8 धनु, 9 मकर, 10 कुंभ, 11 मीन.

तीन सबसे लोकप्रिय मान कहाँ हैं:

- **सूर्य**: `data.planets` में एंट्री जिसमें `"name": "Sun"` है, पहला।
- **चंद्रमा**: `data.planets` में एंट्री जिसमें `"name": "Moon"` है, दूसरा।
- **असेंडेंट**: `data.houses.ascendant`।
- **उपयोग किया गया ऑफ़सेट**: `data.input.timezoneOffset`।

उपरोक्त उदाहरण के लिए: सूर्य 54.34, इसलिए वृषभ; चंद्रमा 296.39, मकर; असेंडेंट 159.26, कन्या; ऑफ़सेट 4।

## इसका खर्च कितना है

- `POST /v1/chart` की लागत 20 क्रेडिट है। पूरी तालिका पेज पर है [एन्डपॉइंट लागत](/credits/).
- वही अनुरोध जो पाँच मिनट के भीतर फिर से भेजा जाता है, कैश से लौटता है और क्रेडिट नहीं घटता। टेस्ट रन जो एक ही बॉडी दोहराता है, बजट नहीं खर्च करता.
- `GET /v1/public/horoscope/daily` कोई क्रेडिट नहीं लेता। बिना कुंजी या Free प्लान की कुंजी के यह IP एड्रेस से प्रति घंटे 30 अनुरोध की लिमिट में गिना जाता है, और ऑटोमेशन प्लेटफ़ॉर्म अपने एड्रेस को क्लाइंट्स में बाँटते हैं। पेड प्लान की कुंजी की अपनी लिमिट होती है।