الروابط العامة وروابط العرض
تتيح لك Survanta مشاركة نوعين من الروابط تعمل دون الحاجة إلى حساب في Survanta:
- روابط الاستبيانات العامة — يستطيع كل من يملك الرابط الإجابة على استبيانك.
- روابط العرض — يستطيع كل من يملك الرابط قراءة النتائج فقط، لا أكثر.
وكلاهما يعتمد على اشتراك مؤسستك.
روابط الاستبيانات العامة
| الحالة | ما يراه الزائر |
|---|---|
| الاشتراك ساري | يعمل الرابط وفق ما ضبطته، وتُجمَع الردود |
| الاشتراك منتهٍ | يُبلِّغ الرابط بأن الاستبيان غير متاح، فلا يمكن فتحه ولا إرسال أي رد |
| بعد التجديد | يعمل الرابط نفسه من جديد كما كان تمامًا |
يتوقف الجمع عند الانتهاء. فلا يستطيع الرابط العام مواصلة جمع الردود لمؤسسة انقضى اشتراكها. وأي محاولة إرسال خلال تلك الفترة تُرفض ولا يُحفظ شيء.
ولا تُتلَف روابطك أبدًا. فالانتهاء لا يُلغي الرابط العام ولا يحذفه ولا يُبطله، والتجديد لا يستبدله. ولا حاجة إلى إنشاء رابط جديد أو إعادة توليد رمز QR أو إعادة إرسال أي شيء إلى المشاركين. فما وزّعته يستمر في العمل بمجرد التجديد.
روابط العرض
الوصول عبر رابط العرض مقيَّد بالاشتراك أيضًا. وهذا اختيار سياسة مقصود: فرابط العرض قدرة شاركتها خارج مؤسستك، ومشاركتها تتوقف بتوقف اشتراكك.
| الحالة | ما يراه المُطّلِع |
|---|---|
| الاشتراك ساري | النتائج قابلة للقراءة |
| الاشتراك منتهٍ | الوصول غير متاح |
| بعد التجديد | يعمل رابط العرض نفسه من جديد |
وروابط العرض للقراءة فقط في كل الأحوال. فلا سبيل عبرها لإرسال أي شيء أو تعديله أو تغييره، مهما كانت حالة الاشتراك. كما أن رابط العرض لا يمنح أي وصول إلى لوحة التحكم ولا يُظهر أي شيء يخص مؤسسة أخرى.
ما الذي يُبلَّغ به المشاركون
لا شيء عن وضعك المالي.
فعندما يكون الرابط العام غير متاح، يرى الزائر رسالة محايدة فقط تفيد بأن رابط الاستبيان غير متاح. والاستجابة مطابقة عن قصد لما يظهر عند استخدام رابط مجهول أو مكتوب خطأً، حتى لا يستطيع أي شخص من الخارج معرفة ما إذا كانت المؤسسة موجودة، أو ما إذا كان الرابط صالحًا يومًا، أو ما إذا كان هناك دفع متأخر.
الرابط المعطوب ليس كالاشتراك المنتهي
هاتان حالتان مختلفتان، وتستجيب لهما Survanta بطريقتين مختلفتين عن قصد.
| الحالة | المعنى | ما تُرجعه الواجهة البرمجية |
|---|---|---|
| رابط غير صالح أو مكتوب خطأً أو مُلغى أو منتهٍ أو من نوع آخر | مشكلة مصادقة — بيانات الاعتماد نفسها غير صالحة للاستخدام | رفض عام لا يكشف شيئًا عن أي مؤسسة |
| رابط صالح، لكن اشتراك المؤسسة انقضى | الرابط حقيقي، لكن الخدمة خلفه متوقفة مؤقتًا | نتيجة SubscriptionExpired المحدّدة |
والحالة الثانية وحدها هي التي يمكن أن تكشف حالة الاشتراك، والوصول إليها يتطلب أصلًا رابطًا حقيقيًا ما زال صالحًا ويخص تلك المؤسسة. أما الرابط المجهول فلا يكشف شيئًا إطلاقًا.
للمطوّرين
تستجيب نقاط نهاية الروابط العامة وروابط العرض بصيغة JSON، ولا تعيد توجيه العميل إلى صفحة تسجيل الدخول في لوحة التحكم — فبإمكان العميل على هذين السطحين تحليل كل استجابة بمعالجته المعتادة لـ JSON، ولا ينبغي أن يُرسَل إليه نموذج تسجيل دخول بصيغة HTML.
- بيانات اعتماد غير صالحة من أي نوع: استجابة رفض عامة دون إعادة توجيه.
- بيانات اعتماد صالحة مع اشتراك منتهٍ: الحالة 403 حاملةً
errorCode 1001وcode "SubscriptionExpired". - تُرجع نقطة نهاية الحالة العامة ردًّا محايدًا بأن الرابط «غير متاح» للمؤسسة المنتهي اشتراكها وللرابط المجهول على حد سواء.
راجع عقد الاشتراك في تطبيق الجوال للاطلاع على عقد الأخطاء كاملًا، وقسم روابط وتوكنات الوصول لمعرفة كيفية إنشاء هذه الروابط وإدارتها.