EFox.ApiConnection.Toolkit 2.0.3

Usage/Examples

Usage Example:

    Connection connection = new Connection("api.somedomain.com/");

    User user = new User { Id=1, Name="someName" };

    connection.Post<User>("users", user);



    class User
    {
        public int Id;
        public string Name;
    }

First make an Object type of Connection and add base adress.

There are diffrent ways to do so:

if you want to use diffrent types of data use:

Use empty constructor and SetBaseAdress method

    Connection connection = new Connection();
    connection.SetBaseAdress("api.somedomain.com/");

or use parameterized constructor

    Connection connection = new Connection("api.somedomain.com/");

but if you want to use mostly one type of data:

Use empty constructor and SetBaseAdress method

    Connection<TypeOfData> connection = new Connection<TypeOfData>();
    connection.SetBaseAdress("api.somedomain.com/");

or use parameterized constructor

    Connection<TypeOfData> connection = new Connection<TypeOfData>("api.somedomain.com/");

Making HTTP requests

Get

Get an user with id = 2 from api with url "api.somedomain.com/users/2"

    Connection<User> connection = new Connection<User>("api.somedomain.com/");
    User user = await connection.Get("users/2");

or

    Connection connection = new Connection("api.somedomain.com/");
    User user = await connection.Get<User>("users/2");

Get all users from api with url "api.somedomain.com/users/all"

    Connection<User> connection = new Connection<User>("api.somedomain.com/");

    List<User> allUsers = await connection.GetList("users/all");

or

    Connection connection = new Connection("api.somedomain.com/");

    List<User> allUsers = await connection.GetList<User>("users/all");

Post

    Connection<User> connection = new Connection<User>("api.somedomain.com/");

    User user = new User { Id=1, Name="someName" };

    connection.Post("users", user);

or

    Connection connection = new Connection("api.somedomain.com/");

    User user = new User { Id=1, Name="someName" };

    connection.Post<User>("users", user);

Put

    Connection<User> connection = new Connection<User>("api.somedomain.com/");

    User user = new User { Id=2, Name="someName" };

    connection.Put("users/2", user);

or

    Connection connection = new Connection("api.somedomain.com/");

    User user = new User { Id=2, Name="someName" };

    connection.Put<User>("users/2", user);

Delete

    Connection connection = new Connection("api.somedomain.com/");

    connection.Delete("users/2");