.. Netfiles API documentation master file, created by
   sphinx-quickstart on Fri Mar  6 11:42:21 2020.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Get Datarooms
=============

The ``getDatarooms`` call retrieves the list of datarooms the current user can access, regardless of
whether he/she can access it through the API (``AccessAllowed == true``) or not.

The response is a Hyperwave Object *User* as defined in :doc:`Data Structures </data_structures>`.

Additionllly, you will receive the following Cookies, which you must return to the server for each call
you are making from now on:


Request
-------

Request method is ``getDatarooms``:

::

  GET https://app.netfiles.de/;internal&action=mobile.json&apikey=<YourApiKey>&deviceID=<currentDeviceID>&method=getDatarooms
  Authorization: Basic BASE64(UTF8Bytes(<username>:<password>))
  Accept: application/json


Response
--------

The response is a json object (``application/json``) representing the datarooms of the current user.

E.g.:

.. code:: json

    {
        "count": 1,
        "response": [
            {
                "type": "collection",
                "id": "ID-29855.6388648114937-1",
                "path": "/tombusinessplus",
                "documentClass": "project",
                "version": "",
                "title": "Tom Business Plus",
                "name": "tombusinessplus",
                "creationDate": "2019/07/11 08:45:59 +0000",
                "modificationDate": "2021/02/17 07:55:06 +0000",
                "author": "   ",
                "downloadProhibited": true,
                "writeAccess": true,
                "subDocs": "513",
                "AccessAllowed": true,
                "AccountType": "standard",
                "showAdmins": true,
                "loginVerification": false,
                "showPublicFiles": false,
                "showTasks": true,
                "showDates": true,
                "showBin": true,
                "showFavourites": true,
                "showNewFiles": true,
                "showPrefered": true,
                "showLocked": true,
                "showPrintButton": true,
                "showDisclaimer": true,
                "showPrivateFiles": false,
                "showBack": true,
                "showContacts": false,
                "showDeviceAccess": true,
                "showDisabled": false,
                "showDocuments": true,
                "showForum": false,
                "showGoto": false,
                "showHome": false,
                "showLoginVerification": false,
                "showNewNavigation": true,
                "showNews": false,
                "showPDFInViewer": true,
                "showPasswordDirective": false,
                "showQandA": false,
                "showReload": true,
                "showRightsIcons": true,
                "showSearch": true,
                "showStartpage": false,
                "showTeamFunctions": true,
                "showTitlePath": true,
                "showToBeApproved": false,
                "showUserAdministration": false,
                "showViewer": true,
                "showWelcome": true,
                "showWiki": true,
                "useWatermark": false,
                "disclaimer": {
                    "creationDate": "2021/02/16 14:04:06 +0000",
                    "acceptionDate": "2021/02/16 14:01:35 +0000",
                    "content": "<p>Bitte akzeptieren Sie diesen Disclaimer.</p>"
                }
            },
        ]
    }


Obviously the ``count`` and the content of ``response``-array depend on the current user.