unsplash-net / unsplash-net

🐧 A .Net wrapper for the Unsplash API

Unsplash SDK for .Net

A simple and easy to use client for the Unsplash API

Installation

.Net CLI

dotnet add package Unsplash.Net

Usage

Before using the Unsplash API, register as a developer and read the API Guidelines.

Import and initialize the client using the public authentication token created above.

var client = new UnsplashClient(new ClientOptions
{
    AccessKey = "<Token>"
});

Make A request to any Endpoint. For example you can call below to fetch the list of photos.

var photos = await client.Photos.GetPhotosAsync();

Contribution Guideline

At the moment I haven't got any specific guidelines for the project. Everyone are welcome to contribute.

unsplash-net's Issues

Add usage examples

Add samples examples to show the usage of the library.

Add support for Users api

Add support for users API's - At start we only support public authenticated API's

• Get a user’s public profile
• Get a user’s portfolio link
• List a user’s photos
• List a user’s liked photos
• List a user’s collections
• Get a user’s statistics

Doc Ref: https://unsplash.com/documentation#users

Add editorconfig for consistent code styling

Add support for Stats API's

Add support for Stat API's

• Totals
• Month

Doc ref: https://unsplash.com/documentation#stats

Add support for Topics API's

Add support for Topics Api's - We are only planning to support public authenticated api's

• List topics
• Get a topic
• Get a topic’s photos

Doc ref: https://unsplash.com/documentation#topics

Propose: Add Unsplash Management Client

Instead of instantiating Collections, Photos, Users client explicitly. It would be a useful if we can add a management client which will take care of instantiating these clients and allow use to call the api.

public class UnsplashClient
{
    public IPhotosApi Photos { get; }
    public ICollectionsApi Collections { get; }
    
    // etc
}

So user just have to create a instance of UnsplashClient and call the API's as below.

var client = new UnsplashClient(new ClientOptions());

var photos = await client.Photos.ListAsync();

Add support for Collections API's

Add support for only public authenticated collection API's.

• List collections
• Get a collection
• Get a collection’s photos
• List a collection’s related collections

Doc ref: https://unsplash.com/documentation#collections

Add support for Search API's

Add support for Search API's - We are only planning to support public API's.

• Search photos
• Search collections
• Search users

Doc Ref: https://unsplash.com/documentation#search