Rocket.Unsplash 0.0.1

Rocket.Unsplash

A modern, fully-typed .NET wrapper for the Unsplash API, built for .NET 10 with C# 14.

Features

• Full API coverage — all documented endpoints including read and write operations
• Modern C# — record types, primary constructors, nullable reference types
• Dependency injection — services.AddUnsplash() with IHttpClientFactory integration
• Pagination — PaginatedResult<T> with metadata from response headers
• Search — photos, collections, and users with full filter support
• Auth — public (Client-ID) and user (Bearer) authentication
• Error handling — typed UnsplashApiException with status codes and error messages

Installation

dotnet add package Rocket.Unsplash

Quick Start

Dependency Injection

builder.Services.AddUnsplash(options =>
{
    options.AccessKey = "YOUR_ACCESS_KEY";
});

// For user-authenticated actions:
builder.Services.AddUnsplash(options =>
{
    options.AccessKey = "YOUR_ACCESS_KEY";
    options.BearerToken = "USER_BEARER_TOKEN";
});

Standalone Usage

var client = new UnsplashClient(new HttpClient
{
    BaseAddress = new Uri("https://api.unsplash.com")
});

Inject and Use

public class MyService(IUnsplashClient unsplash)
{
    public async Task DoWorkAsync()
    {
        var photos = await unsplash.Photos.ListAsync(page: 1, perPage: 20);
        var photo = await unsplash.Photos.GetAsync("Dwu85P9SOIk");
        var random = await unsplash.Photos.GetRandomAsync(query: "coffee", orientation: Orientation.Portrait);
        var many = await unsplash.Photos.GetRandomAsync(count: 5, query: "nature");

        var results = await unsplash.Search.SearchPhotosAsync("mountains", perPage: 15);
        var user = await unsplash.Users.GetProfileAsync("jimmyexample");
        var stats = await unsplash.Stats.GetTotalsAsync();
    }
}

API Coverage

Examples

Search Photos with Filters

var results = await unsplash.Search.SearchPhotosAsync(
    query: "ocean",
    page: 2,
    perPage: 20,
    orderBy: SearchPhotosOrderBy.Latest,
    color: "blue",
    orientation: Orientation.Landscape,
    contentFilter: ContentFilter.High);

Collections CRUD

var collection = await unsplash.Collections.CreateAsync(
    title: "My Favorites",
    description: "Best photos",
    @private: false);

await unsplash.Collections.AddPhotoAsync(collection.Id!.Value, "Dwu85P9SOIk");
await unsplash.Collections.RemovePhotoAsync(collection.Id.Value, "Dwu85P9SOIk");
await unsplash.Collections.DeleteAsync(collection.Id.Value);

Pagination

var page1 = await unsplash.Photos.ListAsync(page: 1, perPage: 30);

Console.WriteLine($"Total: {page1.Total}");
Console.WriteLine($"Total Pages: {page1.TotalPages}");

foreach (var photo in page1.Results)
{
    Console.WriteLine($"{photo.Id}: {photo.Urls?.Regular}");
}

Current User (requires Bearer token)

var me = await unsplash.Me.GetCurrentUserAsync();

var updated = await unsplash.Me.UpdateCurrentUserAsync(
    new UpdateCurrentUserRequest
    {
        FirstName = "New Name",
        Bio = "Updated bio"
    });

Error Handling

try
{
    var photo = await unsplash.Photos.GetAsync("invalid_id");
}
catch (UnsplashApiException ex)
{
    Console.WriteLine($"Status: {ex.StatusCode}");
    Console.WriteLine($"Errors: {string.Join(", ", ex.Errors)}");
}

Configuration

Requirements

• .NET 10+
• Unsplash API access key

License

MIT