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

تم تنفيذ كل ما في هذه الصفحات مقابل الإنتاج 2026-09-17. تم استيراد سير العمل الخاص بـ n8n وتشغيله في n8n حقيقي؛ تم كتابة خطوات Zapier وMake وفقًا لتوثيقها الخاص، وقد تم إرسال الطلبات التي تتكونها بالضبط بهذه الصيغة.

من أين يأتي الطلب

يعتمد هذا على المفتاح المطلوب.

• Zapier، Make و n8n ترسل الطلبات من خوادمها. مطلوب مفتاح “خادم فقط” بنطاق نقاط النهاية والميزانية كما هو موضح أدناه. التعليمات: Zapier، Make، n8n.
• Bubble ترسل أيضًا الطلبات من خوادمها، ويوجد المفتاح في الرأس الذي يبقى هناك: Bubble.
• FlutterFlow يتم تجميعه في تطبيق يحتفظ به المستخدم، لذا يجب أن يكون الاستدعاء خاصًا: FlutterFlow.
• Wix، Squarespace، Shopify، Webflow و Tilda تعرض الصفحة في متصفح الزائر. أدخل أداة widget وليس مفتاحًا: مُنشئو المواقع.
• WordPress يرسل الطلبات من خادمك الخاص. يدير المفتاح إضافة AstroWay.

تنبيه

المفتاح العام pk_ لا يعمل مع Zapier أو Make أو n8n. يرفض الطلب بدون origin من قائمته، وهذه الأدوات لا ترسل origin. إنه يحصل فقط على /v1/public/* و /v1/embed/* من صفحة الموقع.

مفتاح الأتمتة

كل من يمكنه تعديل Zap أو سيناريو أو سير عمل، يرى المفتاح داخله. لذا أعط كل أتمتة مفتاحها الخاص وحددها بما تفعله.

1. في لوحة التحكم، افتح مفاتيح API وانقر على مفتاح جديد. سمِّه حسب الأتمتة، على سبيل المثال zapier-intake-form.
2. في حقل أين سيتم استخدام هذا المفتاح؟، اترك خادم فقط.
3. انسخ المفتاح. يظهر الحوار كاملاً مرة واحدة؛ لاحقًا يمكن الوصول إليه عبر إظهار في قائمة المفتاح.
4. في قائمة المفتاح، افتح نطاق نقاط النهاية واذكر المسارات التي تستدعيها الأتمتة، واحدة في كل سطر: chart للمخطط Natal، public/horoscope/* للرؤيا اليومية.
5. في نفس القائمة، افتح تعيين الميزانية وحدد عدد الاعتمادات التي يمكن أن ينفقها هذا المفتاح في دورة.

يحصل الاستدعاء خارج القائمة على 403 ENDPOINT_NOT_IN_SCOPE. يحصل المفتاح الذي استنفد ميزانيته على 429 KEY_BUDGET_EXHAUSTED، حتى عندما لا تزال هناك اعتمادات في الحساب، لذا ستنتهي الأتمتة التي تعيد نفسها عند الرقم المحدد. كلا الحدثين يعملان على أي خطة و موضحان في قسم المصادقة.

أرسل لحظة الميلاد وليس الإزاحة

تعطي النموذج التاريخ والوقت على الساعة والمكان. أرسلها هكذا:

{
  "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 موضحة في تنسيقات الحقول.

كيفية تحويل الطول إلى علامات

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 اعتمادًا. الجدول الكامل على صفحة تكلفة نقاط النهاية.
• نفس الطلب المرسل مرة أخرى خلال خمس دقائق، يتم إرجاعه من التخزين المؤقت ولا يتم خصم منه. التشغيل التجريبي الذي يعيد جسمًا واحدًا، لا ينفق ميزانية.
• GET /v1/public/horoscope/daily لا ينفق اعتمادات. بدون مفتاح أو مع مفتاح على خطة مجانية، يتم حسابه في حد 30 طلبًا في الساعة من عنوان IP، وتقسم منصات الأتمتة عناوينها بين العملاء. المفتاح على خطة مدفوعة له حد خاص به.