مهام للوكيل

تمت كتابة هذه الصفحة من سجلات البيع خلال 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 ونقاط النهاية الأخرى:

terminal

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}'

قواعد الحقول الدقيقة: تنسيقات الحقول. المفتاح aw_test_* لا يستهلك الاعتمادات، لذا يجب استخدامه للتطوير.

اقرأ المواصفات، لا تخمن

لكل عملية صفحة مكافئة markdown: نفس الرابط مع إضافة .md. هذا هو ما يجب أن تقدمه للنموذج بدلاً من HTML.

terminal

curl https://api.astroway.info/docs/api/operations/acg_categories_get.md

بالقرب: /llms.txt كنقطة دخول و/v1/openapi.json كمواصفات كاملة.

عندما لا يكون المفتاح مطلوبًا

بدون مفتاح، تعمل ثلاث مساحات اسمية، جميعها بحد IP: /v1/public/* (تسعة نقاط نهاية حسابية، مدرجة في صفحة مجاني)، /v1/embed/* (الأدوات الجاهزة) و/v1/reference/* (المراجع: البرج، الكواكب، الجوانب).

الرد بدون مفتاح يحتوي على حقل إضافي _footer بتوقيع، وهذا طبيعي، هكذا يتم تمييز المستوى المجاني.

التالي

• أخطاء شائعة: ما الذي يعيده 4xx بشكل متكرر
• المفاجآت: سلوك مفاجئ
• MCP: واحد من أدوات Claude، Cursor والباقي