مساحات العمل

مساحة العمل

قد ينتمي الشخص إلى عدة مساحات، فرمز وصول المستخدم وحده لا يكفي لتحديد واحدة — بل X-Workspace-Id هو ما يحددها. أما مفتاح API فيسمّي مساحته أصلًا ويتجاهل الترويسة.

نقاط النهاية

curl -X POST https://whats.azzamkh.sa/api/v1/workspaces \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme", "locale": "ar", "timezone": "Asia/Riyadh" }'

# 201 Created — role and permissions are resolved for THIS user.
# {
#   "id": "ws_...",
#   "name": "Acme",
#   "slug": "acme",
#   "status": "active",
#   "is_personal": false,
#   "locale": "ar",
#   "timezone": "Asia/Riyadh",
#   "created_at": "2026-08-14T09:00:00.000Z",
#   "role": "owner",
#   "permissions": ["workspace.read", "workspace.manage", ...]
# }

• كل مسار في هذا القسم معلن لـ sessionToken وحده — فمفتاح API يخص مساحة عمل ولا يستطيع إنشاء واحدة ولا سردها ولا أرشفتها. انظر المصادقة.
• الطلب DELETE يؤرشف. ويجيب بالمعرّف والحالة الجديدة، ولا يتلف بيانات المستأجر.
• إنشاء مساحة عمل محدود بـ 20 في الساعة لكل شخص.
• المسار GET /v1/auth/me يعيد المستخدم فقط. أما العضويات فتأتي من GET /v1/workspaces، وهو أيضًا موضع role وpermissions المحلولة.

تسمية مساحة العمل في الطلب

سياق المستأجر صريح في كل مكان. ولا يوجد افتراضي ضمني، عن قصد: فالمفتاح الذي صُكّ في مساحة العمل الخطأ لا يمكن استرجاعه. انظر المصادقة.

الأشخاص والمال

الأعضاء والأدوار والدعوات والفرق كلها موارد فرعية لمساحة العمل ولها صفحتها: الفرق والدعوات. أما الاشتراك وكشوفه ففي الفوترة.

الأخطاء المهمة هنا

كل رمز وحالته في صفحة الأخطاء.