الفرق والدعوات

ما الموجود هنا

يحمل الأعضاء دورًا يُحلّ إلى تصاريح. وتجمع الفرق الأعضاء وقد تُحصر في قنوات. والدعوات هي طريق المرء ليصير عضوًا. وكل ذلك يتفرع عن مساحة عمل.

الأعضاء والأدوار

معرّف العضوية بصيغة mem_…، وهو ليس معرّف المستخدم الذي تعرضه بقية الواجهة للشخص نفسه — فإسناد محادثة يأخذ معرّف العضوية، والجلسة لا تحمله، ولذلك يتطلب الاستحواذ على محادثة البحث عن نفسك في قائمة الأعضاء أولًا. أما تصاريح المتصل المحلولة فتوجد على مساحة العمل نفسها، انظر المصادقة.

الدعوات

curl -X POST https://whats.azzamkh.sa/api/v1/workspaces/ws_.../invitations \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "email": "agent@example.com", "role": "agent" }'

# 201 Created
# {
#   "id": "inv_...",
#   "email": "agent@example.com",
#   "role": "agent",
#   "status": "pending",
#   "expires_at": "2026-08-21T09:00:00.000Z",
#   "created_at": "2026-08-14T09:00:00.000Z"
# }

# The invitee accepts with the token from the email. This route names no
# workspace and takes no scope — the token carries both.
curl -X POST https://whats.azzamkh.sa/api/v1/invitations/accept \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "token": "..." }'

# 200 OK
# { "workspace_id": "ws_...", "role": "agent", "already_member": false }

• المسار POST /v1/invitations/accept لا يسمّي مساحة عمل ولا يأخذ نطاقًا — فالرمز يحمل الاثنين. ويجيب بـ already_member بدل الفشل حين يكون الشخص عضوًا بالفعل، فالقبول مرتين آمن.
• تحمل الدعوة expires_at وstatus. والإلغاء حذف للدعوة، ويجيب بالمعرّف والحالة الجديدة.
• الدعوة محدودة بـ 50 في الساعة لكل مساحة عمل، والقبول بـ 20 في الساعة لكل شخص.

الفرق

• المسار POST …/teams عديم الأثر الجانبي على زوج مساحة العمل والاسم: يعيد الفريق الموجود بدل الرفض، فلا يوجد خطأ «الاسم مستخدم» لتعرضه.
• حذف فريق وإزالة عضو وإزالة عضو فريق، كلها تجيب بـ removed — لا deleted.
• المسار GET …/teams مُرقَّم بالمؤشر. أما …/teams/:id/members و…/teams/:id/channels فليسا كذلك — يجيبان بمصفوفة data بسيطة.
• يحمل صف عضو الفريق member_id وuser_id معًا. وقد تكون member_id سلسلة فارغة حين يزول صف العضوية، فلا تجعلها مفتاح قائمة دون تحقّق.

# Granting INVERTS the intuition: a channel nobody has confined is visible
# to everyone with messages.read, and the first grant confines it.
curl -X PUT https://whats.azzamkh.sa/api/v1/workspaces/ws_.../teams/tm_.../channels \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{ "channel_ids": ["ch_..."] }'

# 200 OK
# { "team_id": "tm_...", "channel_ids": ["ch_..."] }

# Sending [] does not hide anything: it removes THIS team's grants, and
# the channel becomes workspace-wide again if no other team holds it.

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

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