# Zapier

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

<Aside type="caution" title="Zapier का सशुल्क प्लान आवश्यक है">
API by Zapier, Webhooks by Zapier और Formatter प्रीमियम एप्लिकेशन हैं। Zapier के दस्तावेज़ों में इन तीनों को Free प्लान पर अनुपलब्ध बताया गया है, और Lookup Table चरण के लिए Professional या उच्चतर प्लान की आवश्यकता होती है। Free प्लान पर, [Make](/integrations/make/) या [n8n](/integrations/n8n/) का उपयोग करें।
</Aside>

सबसे पहले, [स्वचालन के लिए कुंजी](/integrations/#ключ-для-автоматизації) अनुभाग में वर्णित अनुसार, `chart` स्कोप के साथ एक कुंजी बनाएँ।

## 1. कुंजी को कनेक्शन में डालें

Webhooks by Zapier चरण में दर्ज किए गए हेडर उसी चरण में संग्रहीत होते हैं, और Zap तक पहुँच रखने वाला कोई भी व्यक्ति उन्हें देख सकता है। API by Zapier उन्हें कनेक्शन में रखता है।

1. **Apps** पेज पर, **+ Add connection** पर क्लिक करें और **API by Zapier** चुनें।
2. **Authentication type**: Static Headers (API key)।
3. **Headers**: `X-Api-Key: ` और उसके बाद आपकी कुंजी, एक ही पंक्ति में।
4. **Domain filter**: `api.astroway.info`, ताकि कनेक्शन को कहीं और निर्देशित न किया जा सके।

## 2. चार्ट को कॉल करें

एक क्रिया जोड़ें, **API by Zapier**, इवेंट **API Request** और कनेक्शन चुनें।

- **Method**: `POST`।
- **URL**:

  ```
  https://api.astroway.info/v1/chart
  ```

- **Body**: नीचे दिया गया JSON, मानों के बजाय ट्रिगर फ़ील्ड के साथ।

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

प्रत्येक मान को संबंधित ट्रिगर फ़ील्ड से बदलें और प्रत्येक के चारों ओर उद्धरण चिह्नों को बनाए रखें, संख्याओं के लिए भी। Zapier मैप किए गए फ़ील्ड को सादे टेक्स्ट के रूप में सम्मिलित करता है और स्वयं उद्धरण चिह्न नहीं जोड़ता है, जबकि API `"50.45"` को एक संख्या के रूप में स्वीकार करता है। चरण के Headers में कुंजी न जोड़ें: इसे कनेक्शन द्वारा प्रतिस्थापित किया जाता है।

चरण का परीक्षण करें। सही प्रतिक्रिया `"ok": true` से शुरू होती है, और उदाहरण के लिए `data.input.timezoneOffset` `4` के बराबर है: उस दिन कीव का ऑफ़सेट।

## 3. लग्न को राशि में बदलें

दो Formatter चरण।

**Formatter, इवेंट Numbers, Spreadsheet-Style Formula रूपांतरण।** फ़ॉर्मूला:

```
FLOOR(ASCENDANT / 30)
```

जहाँ `ASCENDANT` के स्थान पर चरण 2 से `data.houses.ascendant` प्रतिस्थापित किया गया है। उदाहरण के लिए, परिणाम `5` है।

**Formatter, इवेंट Utilities, Lookup Table रूपांतरण।** Lookup Key फ़ॉर्मूले का परिणाम है। तालिका:

| Key | Value |
|---|---|
| 0 | Aries |
| 1 | Taurus |
| 2 | Gemini |
| 3 | Cancer |
| 4 | Leo |
| 5 | Virgo |
| 6 | Libra |
| 7 | Scorpio |
| 8 | Sagittarius |
| 9 | Capricorn |
| 10 | Aquarius |
| 11 | Pisces |

उदाहरण के लिए, परिणाम `Virgo` है। यूक्रेनी नाम प्राप्त करने के लिए, उन्हें Value कॉलम में दर्ज करें।

सूर्य और चंद्रमा की गणना भी इसी तरह की जाती है। ये `data.planets` में पहली और दूसरी प्रविष्टि हैं, प्रत्येक अपनी `longitude` के साथ: उदाहरण के लिए 54.34 (वृषभ) और 296.39 (मकर)।

## यदि तुम Webhooks by Zapier का उपयोग करते हो

यह काम करता है, लेकिन कुंजी कनेक्शन में नहीं, बल्कि चरण में होती है। चार्ट के लिए, **Custom Request** इवेंट चुनें: यह Data फ़ील्ड को ठीक उसी तरह भेजता है जैसे उसे दर्ज किया गया है, इसलिए ऊपर दिया गया JSON बिना किसी बदलाव के जाएगा। **Method** को `POST` पर सेट करें, और **Headers** में `X-Api-Key` अपनी कुंजी के साथ, और `Content-Type` को `application/json` मान के साथ जोड़ें।

## जब चरण विफल होता है

- **`400 INVALID_FIELD` `details` में `timezone` के साथ**: मैप किया गया ज़ोन खाली है, यह `EST` जैसा एक संक्षिप्त नाम है या ज़ोन का नाम नहीं है।
- **`400` `details` में `date` या `time` के साथ**: ट्रिगर का प्रारूप `YYYY-MM-DD` / `HH:MM:SS` नहीं है; कॉल करने से पहले तारीख के लिए एक Formatter चरण जोड़ें।
- **`403 ENDPOINT_NOT_IN_SCOPE`**: कुंजी के स्कोप में `chart` नहीं है।
- **`429 KEY_BUDGET_EXHAUSTED`**: कुंजी ने अपना बजट समाप्त कर दिया है; इसे डैशबोर्ड में बढ़ाएँ।

API जियोकोड नहीं करता है। यदि ट्रिगर में केवल स्थान का नाम है, तो निर्देशांक ट्रिगर से ही या जियोकोडिंग सेवा से आने चाहिए जिसके लिए तुम्हारे पास एक कुंजी है।