Forbury.Integrations 1.4.3

.NET 5.0 .NET Core 3.1
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Forbury.Integrations --version 1.4.3
NuGet\Install-Package Forbury.Integrations -Version 1.4.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Forbury.Integrations" Version="1.4.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Forbury.Integrations --version 1.4.3
#r "nuget: Forbury.Integrations, 1.4.3"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Forbury.Integrations as a Cake Addin
#addin nuget:?package=Forbury.Integrations&version=1.4.3

// Install Forbury.Integrations as a Cake Tool
#tool nuget:?package=Forbury.Integrations&version=1.4.3

Forbury

Forbury Integrations

NuGet Licence GitHub Workflow Status GitHub Workflow Status

This .NET client library provides a quick & easy option for integrating with Forbury APIs.

Note: In order to use this library, you must be an existing Forbury customer and have an API ClientId and ClientSecret. To learn more about becoming a Forbury customer, or if you already are and would like access, please contact us.

Documentation

Wiki page - Contains full documentation including examples.

Swagger API documentation - Contains the ability for sample requests and available endpoints.

Quick Start Guide

In order to get started, please follow these steps.

1. Install the NuGet package using one of the following commands

Package Manager

Install-Package Forbury.Integrations -Version 1.2.0

.NET CLI

dotnet add PROJECT package Forbury.Integrations --version 1.2.0

PackageReference

<PackageReference Include="Forbury.Integrations" Version="1.2.0" />

For a full list of the latest releases, please see the package release page.

2. Add the following to your appsettings.config (replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET)

"Forbury": {
  "Api": {
    "Url": "https://api.forbury.com/",
    "Version": 1
  },
  "Authentication": {
    "Url": "https://account.forbury.com/",
    "ClientId": "YOUR_CLIENT_ID",
    "ClientSecret": "YOUR_CLIENT_SECRET"
  } 
}

3. Add the following inside your Startup.cs (.NET 3.1 and .NET 5).

public IConfiguration Configuration { get; }

public void ConfigureServices(IServiceCollection services)
{        
    services.AddForburyApi(Configuration);
    ...
}

Alternatively, if you are using the new .NET 6 design without a Startup.cs, add the following inside your Program.cs (.NET 6).

using Forbury.Integrations.API;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddForburyApi(builder.Configuration);

You should now be ready to use the API!

Example API Usage

Example usage inside a Service.

Note: Please take note of the using statements, its important to import usings from the correct version (see versions below).

using Forbury.Integrations.API.v1.Dto;
using Forbury.Integrations.API.v1.Interfaces;
...

public class ForburyDataService
{
    private readonly IForburyTeamApiClient _forburyTeamApiClient;

    public ForburyDataService(IForburyTeamApiClient forburyTeamApiClient)
    {
        _forburyTeamApiClient = forburyTeamApiClient;
    }

    public async Task GetTeams(int amount = 20, int page = 1)
    {
        PagedResult<TeamDto> teams = await _forburyTeamApiClient.GetTeams(amount, page);

        // Do work here
        ...
    }

    public async Task GetModelDataForTeam(int id, DateTime? fromDate = null, int amount = 20, int page = 1)
    {
        PagedResult<ModelDto> models = await _forburyTeamApiClient.GetModelsByTeamId(id, fromDate, null, amount, page);

        // Do work here
        ...
    }
}

Versions

Currently available API versions:

  • v1
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp3.1
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.5.0-beta4 34 12/7/2022
1.5.0-beta3 61 11/23/2022
1.5.0-beta2 38 11/11/2022
1.5.0-beta 131 11/8/2022
1.4.3 69 12/5/2022
1.4.2 77 12/2/2022
1.4.1 132 10/26/2022
1.4.0 511 9/1/2022
1.3.0 385 8/4/2022
1.2.1 201 7/25/2022
1.2.0 273 7/24/2022
1.1.0 324 7/7/2022
1.0.7 209 6/27/2022
1.0.6 631 4/11/2022
1.0.5 375 3/29/2022
1.0.4 224 1/30/2022
1.0.3 267 7/6/2021
1.0.2 246 6/21/2021
1.0.1 1,854 5/17/2021
1.0.0 230 5/5/2021