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

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

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

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

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

تنبيه

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

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

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

1. في لوحة التحكم افتح API-ключі واضغط مفتاح جديد. سمّه وفقًا للأتمتة، مثلًا zapier-intake-form.
2. في الحقل أين سيُستخدم هذا المفتاح؟ اختر فقط الخادم.
3. انسخ المفتاح واحفظه: يظهر الحوار المفتاح بالكامل مرة واحدة. إذا فقدت المفتاح، اضغط تحديث المفتاح في قائمة المفتاح: ستحصل على مفتاح جديد، والقديم سيتوقف عن العمل.
4. في قائمة المفتاح افتح نطاق نقاط النهاية وسرد المسارات التي تستدعيها الأتمتة، كل مسار في سطر منفصل: chart لخريطة الميلاد، 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 لا يستهلك ائتمانات. بدون مفتاح أو بمفتاح على خطة Free يُحسب ضمن حد 30 طلبًا في الساعة من عنوان IP، ومنصات الأتمتة تقسم عناوينها بين العملاء. المفتاح على الخطة المدفوعة له حد خاص به.