Configure

The IssuuSDK targets .NET Standard 2.0 (netstandard2.0) which means you can install the SDK on any project that supports .NET Standard 2.0. You can view the supported frameworks and platforms on NuGet.org.

.NET Core and .NET 5+

Apps written for the newer .NET platform can be configured to use the IssuuSDK through app configuration and service registration.

Configuring Issuu settings

To configure the IssuuSDK, add the following to your appsettings.json file:

{
  "Issuu": {
    "Token": "{token}"
  }
}

Authentication Tokens

The IssuuSDK does not currently support generating authentication tokens. To generate a token for your app, please visit API Settings when you have signed into Issuu.

The app configuration is mapped to the IssuuSettings type, which supports the following properties:

Property	Type	Default Value	Notes
Token	string	null	Your authentication token
BaseUrl	string	https://api.issuu.com/v2	The base URL for the Issuu API
CaptureRequestContent	bool	false	If enabled, each request will capture the request content
CaptureResponseContent	bool	false	If enabled, each request will capture the response content

Service registration

To add IssuuSDK services to your Dependency Injection container, you need to add a call to AddIssuu() to your IServiceCollection. There are a few flavours of a .NET app, so you'll need to decide which one you are using

Using WebApplication.CreateBuilder()

This is the typical approach to modern ASP.NET Core apps, typically using Minimal APIs.

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddIssuu();

Using a Startup class

This is an approach used by ASP.NET Core web apps.

public class Startup
{
  public void ConfigureServices(IServiceCollection services)
  {
    services.AddIssuu();
  }
}

Using HostBuilder

The HostBuilder approach targets non-ASP.NET Core scenarios, such as Windows services, or Function apps (Azure Functions, AWS Lambda, etc.) that require host lifetime management.

var builder = new HostBuilder()
  .ConfigureServices(services => {
    servies.AddIssuu();
  });

Note on Lifetime

The AddIssuu() extension method registers a per-scope lifetime for the default API client. This is typical for ASP.NET Core apps where the lifetime scope is per-request. For non-ASP.NET Core hosts, you may need to manage the lifetime through a lifetime scope, otherwise you may up with a singleton instance of the client.

.NET Framework

Vanilla .NET Framework

If you are targeting .NET Framework but will be managing the lifetime of the SDK services yourself, you can easily create an instance of a client and settings. See Client Usage for more information.

Integration through an Inversion of Control (IoC) container

If you are targeting .NET Framework, you may or may not be using a IoC container, such as Autofac, or StructureMap, etc. It is possible to wire up the IssuuSDK using the same strategy as the default for ASP.NET Core, however as there are numerous IOC containers available, we haven't documented them here. Below is an outline of the recommended service lifetime for the services provided by the SDK:

Service	Implementation	Recommended Lifetime	Notes
IssuuSettings	IssuuSettings	Singleton	Pre-configure this instance.
IIssuuHttpClientFactory	IssuuHttpClientFactory	Scoped	This is for customising a HttpClient instance.
IIsuuApiClientFactory	IssuuApiClientFactory	Scoped
IIsuuApiClient	IssuuApiClient	Scoped	This is the default instance when injected directly.