Get the .NET Cloud Server SDK

SDK version 1.1.0 Cloud API version 1.x

Table of Contents

Overview

This guide will show you how to programmatically perform common management tasks using the .NET SDK for the 1&1 REST API.

This .NET library is a wrapper for the 1&1 REST API. All API operations are performed over SSL and authenticated using your 1&1 token key. The API can be accessed within an instance running in 1&1 or directly over the Internet from any application that can send an HTTPS request and receive an HTTPS response.

Getting Started

Before you begin you will need to have signed up for a 1&1 account. The credentials you create during sign-up will be used to authenticate against the API.

To create a user and generate an API token that will be used to authenticate against the REST API, log into your 1&1 control panel. Go to the Server section -> Management -> Users.

Installation

The official .NET library is available from the 1&1 GitHub account found here. To install the latest stable version, clone the repository, then add the binaries to your project.

Configuration

Depending on the type of project, you have the option to either create an App.config or Web.config file to interact with the service before you begin, This file should contain the following values:

  <appSettings>
    <add key="APIToken" value="api token goes here"/>
    <add key="APIURL" value="https://xxxxxx.1and1.com/v1"/>
  </appSettings>

Or you can pass the required values when initializing the client through your code.

OneAndOneClient client = OneAndOneClient.Instance(new Client.RESTHelpers.Configuration()
        {
            ApiKey="token",
            ApiUrl="url"
        });

Using the Driver

Here is a simple example on how to use the library.

List all Servers:

var servers=OneAndOneClient.Instance().Servers.Get();

This will list all servers under your 1&1 account.

Additional Documentation and Support

You can engage with us in the community and we'll be more than happy to answer any questions you might have.

To view or contribute to this project, visit the GitHub repository.

Copyright (c) 2016 1&1 Internet SE

Last updated: 7/12/2017

Comments

Tags: Management