# التكاملات بدون كود

تم تنفيذ كل ما في هذه الصفحات مقابل الإنتاج 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** تعرض الصفحة في متصفح الزائر. أدخل أداة widget وليس مفتاحًا: [مُنشئو المواقع](/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` للمخطط Natal، `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` لا ينفق اعتمادات. بدون مفتاح أو مع مفتاح على خطة مجانية، يتم حسابه في حد 30 طلبًا في الساعة من عنوان IP، وتقسم منصات الأتمتة عناوينها بين العملاء. المفتاح على خطة مدفوعة له حد خاص به.