ما الذي تغطّيه الحزمة — وما لا تغطّيه

لماذا الحزمة ليست كل شيء

سطح الحزمة اختيار لا نقص. كل ما فيها آمن للاستدعاء بمفتاح خادم يعمل لحساب شخص واحد. أما ما بقي خارجها فأغلبه لأحد ثلاثة أسباب: يحتاج جلسة مستخدم حقيقية (تسجيل الدخول، الرسائل، الإشعارات)، أو يفرّق على أشخاص بأسمائهم في نداء واحد (إسناد المهام، منح الأوسمة)، أو يتطلّب رفع ملف وهذا السطح بلا رفع (الوسائط، المرفقات).

كيف تنادي ما ليس في الحزمة

نفس المفتاح، نفس الترويسة، لكن بـ HTTP خام. العقد واحد — الحزمة ليست بوابة بل غلاف رفيع، فما ليس فيها ليس ممنوعاً بل غير ملفوف.

# Wrapped by the SDK
curl https://mygurb.com/api/sdk/members -H "X-Api-Key: $GURB_API_KEY"

# Not wrapped — same key, same header, called directly
curl https://mygurb.com/api/notifications -H "X-Api-Key: $GURB_API_KEY"

المرجع الكامل للمنصة

كل مجموعة أدناه لها صفحتها في مرجع API الكامل، مع كل عملية ومعاملاتها واستجابتها.