# एजेंट के कार्य

यह पेज 30 दिनों के बिक्री लॉग से लिखा गया है, न कि कल्पना से। नीचे वे कॉल हैं जो इंटीग्रेटर कुंजी के साथ वास्तव में करते हैं, आवृत्ति के क्रम में।

## सबसे अधिक बार कॉल किए जाने वाले

| एंडपॉइंट | 30 दिनों में सफल कॉल | क्यों |
|---|---|---|
| `POST /v1/human-design` | 12 563 | बॉडिग्राफ: प्रकार, प्रोफ़ाइल, अधिकार, चैनल |
| `POST /v1/chart` | 11 763 | जन्म कुंडली: ग्रह, घर, पहलू |
| `POST /v1/transits` | 1 999 | जन्म कुंडली पर ट्रांज़िट्स उस तारीख के लिए |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | वेदिक अवधि विमशोतारी |
| `POST /v1/houses` | 861 | सिर्फ कुस्पिड और कोण, बिना ग्रहों के |
| `POST /v1/planets` | 761 | सिर्फ पिंडों की स्थितियां |
| `POST /v1/acg` | 704 | अस्त्रोकार्टोग्राफी, विश्व भर की रेखाएँ |
| `POST /v1/transit-calendar` | 678 | एक अवधि के लिए ट्रांज़िट कैलेंडर |
| `POST /v1/horoscope/daily` | 549 | दिन के लिए टेक्स्ट (AI) |
| `POST /v1/synastry` | 437 | दोनों कुंडलियों की संगतता |

`GET /v1/auth/keys/me` (262) इस सूची में भी: एजेंट काम शुरू करने से पहले कुंजी की जाँच करते हैं। यह मुफ्त है और कोई क्रेडिट खर्च नहीं करता।

## न्यूनतम कॉल

एक ही बॉडी `chart`, `houses`, `planets`, `human-design`, `transits` और बाकी कार्ड एन्डपॉइंट्स के लिए काम करती है:

<Code lang="bash" title="terminal" code={`curl -X POST https://api.astroway.info/v1/chart \\
  -H "X-Api-Key: aw_test_YOUR_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'`} />

फ़ील्ड के सटीक नियम: [फ़ील्ड फ़ॉर्मेट](/agent-setup/field-formats/). कुंजी `aw_test_*` कोई क्रेडिट नहीं खर्च करती, इसलिए इसे इस्तेमाल करके विकास करना चाहिए।

## स्पेसिफिकेशन पढ़ो, अनुमान मत लगाओ

हर ऑपरेशन पेज का एक **markdown-डुप्लिकेट** होता है: वही URL प्लस `.md`। यही चीज़ मॉडल को HTML की जगह देनी चाहिए।

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

साथ में: [`/llms.txt`](https://api.astroway.info/llms.txt) को एंट्री पॉइंट और [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) को पूरी स्पेसिफिकेशन के रूप में।

## जब कुंजी की ज़रूरत नहीं

बिना कुंजी के तीन नेमस्पेस काम करते हैं, सभी IP के हिसाब से लिमिटेड: `/v1/public/*` (नौ गणना एन्डपॉइंट्स, पेज [फ़्री](/free/) पर सूचीबद्ध), `/v1/embed/*` (तैयार विजेट्स) और `/v1/reference/*` (रेफ़रेंस: राशियाँ, ग्रह, पहलू)।

बिना कुंजी के प्रतिक्रिया में अतिरिक्त फ़ील्ड `_footer` सिग्नेचर के साथ आता है, और यह सामान्य है, यही मुफ्त स्तर को दर्शाता है।

## आगे

- [सामान्य त्रुटियाँ](/agent-setup/mistakes/): जो अक्सर 4xx लौटाती हैं
- [छिपे हुए मुद्दे](/agent-setup/gotchas/): ऐसी व्यवहार जो आश्चर्यचकित करता है
- [MCP](/agent-setup/): क्लॉड, कर्सर और बाकी के लिए एक टूल्स कैटलॉग