From 10ed8a6903d177ffce5387131447bd29655bc423 Mon Sep 17 00:00:00 2001 From: Klaas Freitag Date: Mon, 19 Apr 2021 17:25:25 +0200 Subject: [PATCH] Add a driveStatus value to the spaces object. It indicates the status if the user has accepted the space or if it is mandatory like shares or personal. --- docs/adr/0005-api-for-spaces.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/adr/0005-api-for-spaces.md b/docs/adr/0005-api-for-spaces.md index fbc3d45416..0da7559bda 100644 --- a/docs/adr/0005-api-for-spaces.md +++ b/docs/adr/0005-api-for-spaces.md @@ -63,7 +63,8 @@ The reply to both calls is either one or a list of [Drive representation objects "id": "string", "createdDateTime": "string (timestamp)", "description": "string", - "driveType": "personal | business | documentLibrary", + "driveType": "personal | projectSpaces | shares", + "driveStatus": "accepted | pending | mandatory", "eTag": "string", "lastModifiedDateTime": "string (timestamp)", "name": "string", @@ -78,12 +79,13 @@ The meaning of the object are in ownClouds context: 1. **id** - a unique ID identifying the space 2. **driveType** - describing the type of the space. -3. **eTag** - the current ETag of the space -4. **owner** - an owner object to whom the space belongs -5. **webUrl** - the relative Webdav path in ownCloud. It must include the `remote.php` part in oC10 installations. -6. **coowner** - optional array owner objects of the co-owners of a space (*) +3. **driveStatus** - telling the status +4. **eTag** - the current ETag of the space +5. **owner** - an owner object to whom the space belongs +6. **webUrl** - the relative Webdav path in ownCloud. It must include the `remote.php` part in oC10 installations. +7. **coowner** - optional array owner objects of the co-owners of a space (*) -The following driveType values are available in the first step, but might be enhanced later: +The following *driveType* values are available in the first step, but might be enhanced later: * **personal**: The users home space * **projectSpaces**: The project spaces available for the user (*) @@ -91,6 +93,12 @@ The following driveType values are available in the first step, but might be enh The (*) marked types are not defined in the official MS API. +The following *driveStatus* values are available: + +* **accepted**: The user has accepted the space and uses it +* **pending**: The user has not yet accepted the space , but can use it after having it accepted. +* **mandatory**: This is an mandatory space. Used for the personal- and shares-space. The user can not influence if it is visible or not, it is always available. + ### Positive Consequences - A well understood and mature API from Microsoft adopted to our needs.