Interacting with the Drive

Version 2.1 by chaney08 on 2021/07/20 19:52

REST API

The drive is based on Seafile. Seafile comes with a restful API which allows you to interact with the content and libraries. You can find the documentation for the Seafile API here: https://download.seafile.com/published/web-api/home.md

The Collaboratory.Drive is protected using OpenID Connect. The authentication is done by using access tokens. You need to have an application which the user logs into to obtain a token for the user. This application will need an OpenID Connect client to be registered. You can find instructions here: Creating Your OpenID Connect Client.

In order to read from the Collaboratory.Drive, you currently need the `collab.drive` and `email` scopes. In the near future, you will need the `email` scope, as well as the`clb.drive:read` scope to access documents, and the `clb.drive:write` scope to make changes. You can already request these scopes to future proof your application.

To authenticate to the API, you add an `Authorization` header to the HTTP request with the content `Bearer {TOKEN}`.

curl -H "Authorization: Bearer $access_token" https://drive.ebrains.eu/api2/...