# مهام للوكيل

تمت كتابة هذه الصفحة من سجلات البيع خلال 30 يومًا، وليس من الخيال. فيما يلي الاستدعاءات التي يقوم بها المطورون فعليًا بالمفتاح، مرتبة حسب التكرار.

## ما يتم استدعاؤه بشكل متكرر

| Endpoint | عدد الاستدعاءات الناجحة في 30 يومًا | لماذا |
|---|---|---|
| `POST /v1/human-design` | 12 563 | BodyGraph: النوع، الملف، السلطة، القنوات |
| `POST /v1/chart` | 11 763 | المولد: الكواكب، البيوت، الجوانب |
| `POST /v1/transits` | 1 999 | التحوّلات إلى المولد في تاريخ معين |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | فترات Vimshottari الفيدية |
| `POST /v1/houses` | 861 | فقط النقاط الزاوية والزوايا، بدون الكواكب |
| `POST /v1/planets` | 761 | فقط مواقع الأجرام السماوية |
| `POST /v1/acg` | 704 | علم المكان، خطوط على الخريطة العالمية |
| `POST /v1/transit-calendar` | 678 | تقويم التحوّلات لفترة زمنية |
| `POST /v1/horoscope/daily` | 549 | نص يومي (ذكاء اصطناعي) |
| `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**: نفس الرابط مع إضافة `.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/): واحد من أدوات Claude، Cursor والباقي