واجهة المعاينة للضيوف

أنشئ رابط معاينة مؤقتا من الكود بطلب HTTP واحد. هذه النقطة لا تحتاج إلى مفتاح API.

نقطة الوصول

POST /api/guest-preview-links

الطلب

أرسل JSON يحتوي على عنوان IP العام للخادم الجديد واسم النطاق المراد معاينته.

مثال

curl -X POST https://hostsclick.com/api/guest-preview-links \
  -H "Content-Type: application/json" \
  -d '{"ip":"YOUR.SERVER.IP","hostname":"example.com"}'

الاستجابة

يعيد الطلب الناجح الرمز HTTP 201 مع رابط المعاينة والنطاق الفرعي وتاريخ الانتهاء. ينتهي رابط الضيف بعد 10 دقائق من إنشائه.

الحدود

10 طلبات في الدقيقة لكل عنوان IP. الطلبات التي تتجاوز هذا الحد تتلقى الرمز HTTP 429.
يجب أن يكون عنوان IP عاما. نطاقات العناوين الخاصة والمحجوزة مرفوضة.
نطاقات Facebook و X (Twitter) و Reddit غير مسموح بها.

نقاط وصول أخرى

المسارات /api/preview-links و /api/server-diff تحتاج مفتاح API يُرسل في الترويسة X-API-Key أو كرمز Bearer.