# منصات بناء المواقع

منشئ المواقع يعرض صفحتك في متصفح الزائر، لذا القاعدة عكس تعليمات الأتمتة: أنت تدرج الودجت، وليس المفتاح. تم تحميل كلا المقتطفين أدناه من صفحة على نطاق خارجي في Chrome 2026-09-17، وكلاهما لم يظهر.

## أدرج أحد المقتطفات

iframe عادي عندما يكون الحجم معروفًا:

```html
<iframe src="https://api.astroway.info/v1/embed/moon-phase?theme=light&lang=uk"
        width="320" height="360" style="border:0"></iframe>
```

محمل عندما لا تريد اختيار الحجم: يستبدل نفسه بـ iframe ويضبط الارتفاع وفقًا للمحتوى عبر `postMessage`.

```html
<script src="https://cdn.astroway.info/embed.js"
        data-widget="moon-phase" data-lang="uk" data-theme="light"></script>
```

خمسة عشر ودجت، جميع المعلمات وزر النسخ لكل منها في الصفحة [الودجات](/products/embed-widgets/). أي سمة `data-*` تصبح معلمة طلب.

## أين تدرج الكود

| منشئ | ما تبحث عنه |
|---|---|
| Wix | [عنصر إدراج كود HTML](https://support.wix.com/en/article/wix-editor-embedding-a-site-or-a-widget) |
| Squarespace | [كتلة كود](https://support.squarespace.com/hc/en-us/articles/205815908-Code-blocks) |
| Shopify | قسم custom liquid أو محرر كود القالب |
| Webflow | عنصر embed |
| Tilda | كتلة كود HTML، T123 |

بالنسبة لـ Wix و Squarespace الروابط تؤدي إلى وثائقهم؛ الثلاثة المتبقية مسماة باسم الدالة، لأن صفحات الوثائق الخاصة بهم لا تُفتح بالتحقق الآلي، ولن نشير إلى غير موثوق.

## المفتاح غير مطلوب ولا يُقبل

نقاط النهاية `/v1/embed/*` عامة. المفتاح في سمة الصفحة سيراه كل زائر، لذا يتجاهله المحمل ويكتب ذلك في وحدة التحكم.

الحدود: **30 طلبًا في الساعة من IP الزائر**، تُخزن الردود مؤقتًا لمدة خمس دقائق. لذا الصفحة التي يزورها عدد كبير من الزوار تعمل جيدًا، بينما الزائر الواحد الذي يعيد تحميلها باستمرار لا.

## ما لا تستطيع الصفحة استدعاؤه

المتصفح على نطاق خارجي يحصل فقط على استجابة من `/v1/public/*` و `/v1/embed/*`. كل ما هو تحت `/v1/*` يرفض preflight: من صفحة على نطاق خارجي `POST /v1/chart` عادت بدون رأس `access-control-allow-origin`، فحظرها Chrome، بينما `POST /v1/public/chart` من نفس الصفحة أعاد `200`.

لذا إذا أردت أن يدخل الزائر بيانات ميلاده الخاصة ويرى الخريطة، استخدم [نقاط النهاية بدون مفتاح](/free/) أو [الودجت-حاسبة الخريطة الفلكية](/products/embed-widgets/#окремий-віджет-калькулятор-натальної-карти) الذي يحسب مباشرة في المتصفح. كل ما يحتاج إلى مفتاح سري يُنفذ على الخادم: الخاص بك أو في أحد الأدوات من قسم [التكاملات بدون كود](/integrations/).

<Aside type="note" title="Коли стане в пригоді публічний ключ">
من الأفضل إنشاء المفتاح `pk_` إذا كانت الصفحة تتصل بنفسها بـ `/v1/public/*` وكان الحد المشترك للزائر غير كافٍ: في الخطة المدفوعة للمفتاح حد خاص به، وقائمة origin تجعلها غير فعالة على أي نطاق آخر. بالنسبة للودجات أعلاه لا يحتاج إلى أي شيء.
</Aside>