• Get Started


    To get started with using the HiDrive API you'll need 2 things:

    A HiDrive, which you might already have, otherwise you can create a 5GB Free-HiDrive account here.

    App Credentials for your project. You get those by using our application form Get an API Key

    After you have submitted your application, we will check and unlock your project within the next 72 hours and send you a pair of client_id and (in most cases) client_secret to the given email address.

    Notice, that the registration for an API-Key does not yet create a Community-Account or vice versa.

    After you get your client_id and client_secret from us, you can connect to our OAuth 2.0 authentication server. The target is to obtain an access_token with which you can access the HiDrive API. Detailed information about our OAuth 2.0 server can be found here.

    If you registered a "server" or "native" app

    open/redirect a browser-window to
    https://www.hidrive.strato.com/oauth2/authorize?client_id=<client_id>&response_type=code&scope=admin,rw
    Enter your Test-Account login information, allow access and the page will redirect to your registered redirect_uri, containing a code parameter

    To get the access_token, you'll need to make a POST request using this code:
    curl -X POST --data "client_id=<client_id>&client_secret=<client_secret>&grant_type=authorization_code&code=<code>" \
     https://www.hidrive.strato.com/oauth2/token
    The result-json will contain an "access_token" ---> you're done!

    If you registered a "browser" app

    open/redirect a browser-window to
    https://www.hidrive.strato.com/oauth2/authorize?client_id=<client_id>&response_type=token&scope=admin,rw

    Enter your Test-Account login information, allow access and the page will redirect to your registered redirect_uri, containing an access_token parameter ---> you're done!

    For your first API-Request there are just a few things to know:

    SSL only:
    We require all requests to the API to be made over SSL (https:// not http://).

    Encode the access_token:
    The access_token needs to be "base64" encoded in order to be recognized by our API:
    echo -n "<access_token>" | base64
    Then put the token inside the Authorization: Bearer header of your request.

    That's all there is, now let's get to know something about your app itself, using the GET /2.1/app/me endpoint:
    curl -X "GET" -H "Authorization: Bearer <base64_access_token>" \
    -d "fields=id,name,created,developer.name,refresh_toke  n.scope,refresh_token.expires" \
    https://api.hidrive.strato.com/2.1/app/me


    Detailed description of all API endpoints can be found here