ApimaticSplititSdk 1.0.1

Getting Started with splitit-web-api-v4

Introduction

Splitit Orchestration API for managing installment plans.

Install the Package

If you are building with .NET CLI tools then you can also use the following command:

dotnet add package ApimaticSplititSdk --version 1.0.1

You can also view the package at: https://www.nuget.org/packages/ApimaticSplititSdk/1.0.1

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

The API client can be initialized as follows:

Code-Based Initialization

using Microsoft.Extensions.Logging;
using SplititWebApiV4.Standard;
using SplititWebApiV4.Standard.Authentication;
using SplititWebApiV4.Standard.Models;
using System.Collections.Generic;

namespace ConsoleApp;

SplititWebApiV4Client client = new SplititWebApiV4Client.Builder()
    .Oauth2Credentials(
        new Oauth2Model.Builder(
            "OAuthClientId",
            "OAuthClientSecret"
        )
        .OauthScopes(
            new List<OauthScopeOauth2>
            {
                OauthScopeOauth2.ApiV4,
            })
        .Build())
    .ApiKeyCredentials(
        new ApiKeyModel.Builder(
            "X-Splitit-Api-Key"
        )
        .Build())
    .HttpClientConfig(httpClientConfig =>
        httpClientConfig.Timeout(TimeSpan.FromSeconds(100)))
    .Environment(SplititWebApiV4.Standard.Environment.ProductionEnvironment)
    .LoggingConfig(config => config
        .LogLevel(LogLevel.Information)
        .RequestConfig(reqConfig => reqConfig.Body(true))
        .ResponseConfig(respConfig => respConfig.Headers(true))
    )
    .Build();

Configuration-Based Initialization

using SplititWebApiV4.Standard;
using Microsoft.Extensions.Configuration;

namespace ConsoleApp;

// Build the IConfiguration using .NET conventions (JSON, environment, etc.)
var configuration = new ConfigurationBuilder()
    .AddJsonFile("config.json")
    .AddEnvironmentVariables() // [optional] read environment variables
    .Build();

// Instantiate your SDK and configure it from IConfiguration
var client = SplititWebApiV4Client
    .FromConfiguration(configuration.GetSection("SplititWebApiV4"));

See the Configuration-Based Initialization section for details.

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Authorization

This API uses the following authentication schemes.

• OAuth2 (OAuth 2 Client Credentials Grant)
• ApiKey (Custom Header Signature)

List of APIs

• Installment Plan

SDK Infrastructure

Configuration

• Configuration-Based Initialization
• HttpClientConfiguration
• HttpClientConfigurationBuilder
• LogBuilder
• LogRequestBuilder
• LogResponseBuilder
• ProxyConfigurationBuilder

HTTP

• HttpCallback
• HttpContext
• HttpRequest
• HttpResponse
• HttpStringResponse

Utilities

• ApiException
• ApiResponse
• ApiHelper
• CustomDateTimeConverter
• UnixDateTimeConverter