ابنِ موقعك الإلكتروني
واجهة Wzgate العامة — ما الذي تقدّمه، وما الذي يمكنك بناؤه فوقها، والقيم الأربع التي تحتاجها من نظام إدارة العملاء قبل كتابة أول سطر.
كل ما يراه الزائر على موقع مبنيّ على Wzgate يأتي من واجهة واحدة: /api/public/*.
هي واجهة مفتوحة — بلا تسجيل دخول موظّف وبلا حساب في النظام — ومربوطة
بـموقع واحد، فلا يعيد الطلب إلا محتوى الموقع الذي جاء منه.
هذه هي نفس الواجهة التي يعمل عليها الموقع المرجعي للمنصّة. لا يوجد فيها شيء محجوز لا يستطيع موقعك استخدامه.
ما الذي يمكنك بناؤه
يمكن للمؤسسة الواحدة أن تدير أكثر من موقع عام. كل موقع له مفتاح خاص به ونطاقاته وإعداداته، ونوعه هو الذي يحدّد ما تقدّمه له الواجهة:
| نوع الموقع | ما الذي تقدّمه الواجهة |
|---|---|
| عقارات | الكتالوج كاملًا — الوحدات والمشاريع والمطوّرون والمواقع والمزايا والخريطة والبحث — إضافة إلى العملاء المحتملين وطلبات المعاينة وحسابات الزوّار وعمليات البحث المحفوظة وبوابة المُلّاك. |
| إقامات | بوابة الإقامات القصيرة وبحثها (/public/portal و/public/stays/search وتقاويم الحجز). |
| ملف الشركة | محتوى المؤسسة نفسها: الملف التعريفي ونصّ «من نحن» والصفحات القانونية والمدوّنة والنشرة البريدية ونموذج التواصل. |
كل الأنواع تقدّم أيضًا ملف الشركة والمدوّنة ونموذج الاستفسار، لأنها الطريقة التي يعرّف بها أي موقع بنفسه ويستقبل بها طلبًا.
ما الذي تُرسله مع كل طلب
تسافر حقيقتان مع كل نداء:
- أيّ موقع هذا — مفتاح الموقع في ترويسة
X-Site، أو نطاق أضفته إلى الموقع. انظر تعريف موقعك. - أيّ تكامل ينادي — مفتاح واجهة في
X-Api-Key. انظر المفاتيح وCORS.
أما عمليات الكتابة التي يستغلّها الروبوتات فتحمل كذلك رمز Cloudflare Turnstile؛ انظر الحماية من الروبوتات.
الأشياء الأربعة التي تحتاجها من النظام
افتح النظام، ثم الإعدادات ← المواقع، اختر موقعك، وافتح تبويب اربط موقعك. كل ما يلي موجود في تلك الشاشة وحدها.
- عنوان الواجهة الأساسي — مضيف النظام مضافًا إليه
/api، مثلhttps://crm.example.com/api. كل مسار في هذه الوثائق مكتوب تحته:/public/propertiesهو في الحقيقةGET https://crm.example.com/api/public/properties. - مفتاح الموقع — المعرّف القصير لهذا الموقع (
nicheأوzos10…). ترسله في ترويسةX-Site. - المفتاح القابل للنشر (
pk_…) — المفتاح الذي يرسله كود المتصفّح. ليس سرًّا، وهو لا يعمل إلا من نطاقاتك أنت. ويوجد مفتاح سرّي (sk_…) في البطاقة نفسها من أجل خادمك. - النطاقات المسموح بها — المضيفات التي يجيب عليها هذا الموقع. هي التي تحدّد CORS، وهي التي تعرّف الموقع بلا ترويسة، وهي التي تجعل المفتاح القابل للنشر صالحًا. تُضاف من تبويب النطاقات.
إلى أين بعد ذلك
- البداية السريعة — نداء يعمل فعلًا بـ Next.js في عشر دقائق.
- تعريف موقعك — النطاق و
X-Siteوالترويسة المهجورةX-Subdomain. - المفاتيح وCORS — القابل للنشر مقابل السرّي، والتدوير، ولماذا يُفحص المصدر.
- الحماية من الروبوتات — Turnstile على عمليات الكتابة الخمس.
- الأخطاء — شكل جسم الخطأ وكل رمز يمكنك التفرّع عليه.
- حسابات الزوّار — التسجيل والتحقّق والدخول ورمز الزائر.
- حدود المعدّل — السقوف وكيف تتعامل مع 429.
- مرجع الواجهة — كل نقطة نهاية، مولّدة من الواجهة نفسها.
- سجلّ التغييرات — ما الذي تغيّر وما الذي سيُحذف.