تخطَّ إلى المستندات
API

اعرض مساحات عملك

كل مساحة عمل يستطيع الشخص فتحها، تلك التي يملكها أولًا، كما يعرضها مبدّل مساحات العمل في التطبيق.

GET/workspaces

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /workspaces

كل مساحة عمل يستطيع الشخص فتحها، تلك التي يملكها أولًا، كما يعرضها مبدّل مساحات العمل في التطبيق.

مثال

يتطلب account:read. activeWorkspaceId هي مساحة العمل التي يفتحها التطبيق للشخص، وprimaryWorkspaceId أول مساحة أنشأها، ولا يمكن حذفها أبدًا، وpersonalWorkspaceId مساحته الشخصية، التي تضم عنوانه المجاني ولا تُعرض في data.

curl
curl "$OE/workspaces" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [    {      "object": "workspace",      "id": "10417196-e324-4283-af98-66ec62167c47",      "name": "Acme",      "slug": "acme",      "email": "[email protected]",      "isOwner": true,      "ownerId": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",      "plan": "business",      "markUrl": null,      "wordmarkUrl": null,      "createdAt": "2026-08-01T10:00:00.000Z"    }  ],  "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",  "primaryWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",  "personalWorkspaceId": "5b1e7c40-2d9a-4f63-b8e1-0c4d7a2f9e15"}

تعمل هذه الاستدعاءات على شخص، لا على مساحة عمل. يعمل مفتاح API نيابةً عن مالك مساحة العمل التي ينتمي إليها، ويعمل التطبيق نيابةً عن الشخص الذي ربطه. تتطلب القراءة account:read ويتطلب كل تغيير account:write، ولا يقيّد أي دور أيًّا منهما.

يبقى المفتاح أو التطبيق نفسه يعمل لمساحة عمل واحدة بالضبط في كل استدعاء آخر. ولا شيء هنا يوسّع ذلك.

المرجع