منصات بناء المواقع
منشئ المواقع يعرض صفحتك في متصفح الزائر، لذا القاعدة عكس تعليمات الأتمتة: أنت تدرج الودجت، وليس المفتاح. تم تحميل كلا المقتطفين أدناه من صفحة على نطاق خارجي في Chrome 2026-09-17، وكلاهما لم يظهر.
أدرج أحد المقتطفات
Section titled “أدرج أحد المقتطفات”iframe عادي عندما يكون الحجم معروفًا:
<iframe src="https://api.astroway.info/v1/embed/moon-phase?theme=light&lang=uk" width="320" height="360" style="border:0"></iframe>محمل عندما لا تريد اختيار الحجم: يستبدل نفسه بـ iframe ويضبط الارتفاع وفقًا للمحتوى عبر postMessage.
<script src="https://cdn.astroway.info/embed.js" data-widget="moon-phase" data-lang="uk" data-theme="light"></script>خمسة عشر ودجت، جميع المعلمات وزر النسخ لكل منها في الصفحة الودجات. أي سمة data-* تصبح معلمة طلب.
أين تدرج الكود
Section titled “أين تدرج الكود”| منشئ | ما تبحث عنه |
|---|---|
| Wix | عنصر إدراج كود HTML |
| Squarespace | كتلة كود |
| Shopify | قسم custom liquid أو محرر كود القالب |
| Webflow | عنصر embed |
| Tilda | كتلة كود HTML، T123 |
بالنسبة لـ Wix و Squarespace الروابط تؤدي إلى وثائقهم؛ الثلاثة المتبقية مسماة باسم الدالة، لأن صفحات الوثائق الخاصة بهم لا تُفتح بالتحقق الآلي، ولن نشير إلى غير موثوق.
المفتاح غير مطلوب ولا يُقبل
Section titled “المفتاح غير مطلوب ولا يُقبل”نقاط النهاية /v1/embed/* عامة. المفتاح في سمة الصفحة سيراه كل زائر، لذا يتجاهله المحمل ويكتب ذلك في وحدة التحكم.
الحدود: 30 طلبًا في الساعة من IP الزائر، تُخزن الردود مؤقتًا لمدة خمس دقائق. لذا الصفحة التي يزورها عدد كبير من الزوار تعمل جيدًا، بينما الزائر الواحد الذي يعيد تحميلها باستمرار لا.
ما لا تستطيع الصفحة استدعاؤه
Section titled “ما لا تستطيع الصفحة استدعاؤه”المتصفح على نطاق خارجي يحصل فقط على استجابة من /v1/public/* و /v1/embed/*. كل ما هو تحت /v1/* يرفض preflight: من صفحة على نطاق خارجي POST /v1/chart عادت بدون رأس access-control-allow-origin، فحظرها Chrome، بينما POST /v1/public/chart من نفس الصفحة أعاد 200.
لذا إذا أردت أن يدخل الزائر بيانات ميلاده الخاصة ويرى الخريطة، استخدم نقاط النهاية بدون مفتاح أو الودجت-حاسبة الخريطة الفلكية الذي يحسب مباشرة في المتصفح. كل ما يحتاج إلى مفتاح سري يُنفذ على الخادم: الخاص بك أو في أحد الأدوات من قسم التكاملات بدون كود.