.NET SDK

The .NET SDK provides a comprehensive library for easily integrating with the Mambo API. This client library simplifies development by handling authentication, request formatting, and response parsing, allowing you to focus on your application logic. The NUPKG bundle also contains inline documentation to facilitate development with Visual Studio.

To connect to the Mambo API, use one of the service classes provided in the services package. See the code samples below for implementation examples.

Installation

Requirements

• .NET Framework Version 4.0 or greater

Dependencies

• Common Logging 3.3.1
• Common Logging Core 3.3.1
• Newtonsoft Json 13.0.1
• RestSharp 106.12.0

Manual installation

1. How to configure a local NuGet repository using Visual Studio:

   • How to install nuget package locally
   • Tools -> Options -> NuGet Package Manager -> Package Sources
   • Add a new source using the path to the folder which contains the Mambo NuGet package

2. Installing the NuGet package for the SDK:

   • Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution
   • In "Package Source:" select the repository created above
   • Click on "Browse" and select the Mambo package
   • Select your project and click "Install"

Downloads

The .NET SDK can be downloaded as a Nupkg or as a DLL. The DLL contains all of the SDK's dependencies embedded such that they will not clash with your project's dependencies (if the same libraries with different version numbers are used). The recommended approach is to use the Nupkg option, but sometimes it's not possible to remove or upgrade your project's dependencies.

Version:Latest (8.7.2)8.6.58.5.08.4.28.3.18.2.18.1.38.0.47.7.17.6.17.5.07.4.57.3.37.2.17.1.17.0.36.3.66.2.46.1.26.0.1

• Download .NET SDK (nupkg)
• Download .NET SDK (dll)

Documentation

Client initialisation

To initialise the SDK, you'll need to set your credentials and, if using an on-premise installation, the API endpoint URL:

.NET

// Initialisation with client credentials only
MamboClient client = new MamboClient( "public_key", "private_key" );

// Initialisation with advanced configuration options
ClientConfiguration configuration = new ClientConfiguration()
{
  PublicKey = "public_key",
  PrivateKey = "private_key",
  ServerBaseUrl = "https://api.mambo.io",
  LoggingStrategy = new ConsoleOutLoggerFactoryAdapter { Level = LogLevel.Info },
  Language = "en",
  TimeoutMillis = 60000,
  ReadWriteTimeoutMillis = 55000
};

client = new MamboClient(configuration);

client.Activities.createAsync( ... );

Path and query parameters

Use parameter objects to provide path and query parameters to endpoint methods:

.NET

UserGetPointWalletsParams params = new UserGetPointWalletsParams()
{
  SiteUrl = "acmeinc",
  Uuid = "user_uuid",
  PageSize = 10
};

client.Users.Points.getPointWallets( params );

Request options

Use the request options object to provide configuration on a per-request basis. This object can be used to provide idempotency keys or request specific timeouts:

.NET

RequestOptions requestOptions = new RequestOptions();
requestOptions.IdempotencyKey = Guid.NewGuid();

client.Activities.createAsync( "acmeinc", data, requestOptions );

Getting started

Here's a complete example showing how to initialise the client and make a basic API call:

.NET

using Mambo.SDK;
using Mambo.SDK.Model;
using System;

namespace MamboQuickStart
{
  class Program
  {
      static void Main(string[] args)
      {
          // Create client with your API credentials
          MamboClient client = new MamboClient( "your_public_key", "your_private_key" );
          
          var data = new ActivityRequestData 
          { 
              Uuid = "user_uuid",
              Attrs = new ActivityBehaviourAttrsData { Verb = "purchase" }
          };
              
          // Call API and handle response
          try {
              var id = client.Activities.CreateAsync( "acmeinc", data );
              Console.WriteLine( "Activity created with ID: " + id );
          } catch (Exception e) {
              Console.WriteLine( "Error creating activity: " + e.Message );
          }
      }
  }
}

Troubleshooting

Common issues

Connection timeouts

If you experience connection timeouts, you can increase the timeout settings when initialising the client:

.NET

ClientConfiguration configuration = new ClientConfiguration()
{
  PublicKey = "public_key",
  PrivateKey = "private_key",
  TimeoutMillis = 60000,  // 1 minute
  ReadWriteTimeoutMillis = 55000  // 55 seconds
};

client = new MamboClient(configuration);

Logging

Enable debug logging to troubleshoot issues:

.NET

ClientConfiguration configuration = new ClientConfiguration()
{
  PublicKey = "public_key",
  PrivateKey = "private_key",
  LoggingStrategy = new ConsoleOutLoggerFactoryAdapter { Level = LogLevel.Debug }
};

client = new MamboClient(configuration);

---

Related topics

• Activities
• API keys