csharp

Hydrogen Web Components - C# SDK

Installing this SDK in your project will give you the following functionality:

• OAuth 2.0 Authorization of Web Components and WebViews
• Generate App Tokens to authenticate Web Components and WebViews
• Retrieve Nucleus Client and Card data used in Web Component and WebView embed codes as data attributes

For more information, please visit our documentation https://www.hydrogenplatform.com/docs/web-component/v1

Requirements

• .NET 4.0 or later
• Windows Phone 7.1 (Mango)

Dependencies

• RestSharp - 105.1.0 or later
• Json.NET - 7.0.0 or later
• JsonSubTypes - 1.2.0 or later

The DLLs included in the package may not be the latest version. We recommend using NuGet to obtain the latest version of the packages:

Install-Package RestSharp
Install-Package Newtonsoft.Json
Install-Package JsonSubTypes

NOTE: RestSharp versions greater than 105.1.0 have a bug which causes file uploads to fail. See RestSharp#742

Installation

Run the following command to generate the DLL

• [Mac/Linux] /bin/sh build.sh
• [Windows] build.bat

Then include the DLL (under the bin folder) in the C# project, and use the namespaces:

using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

Getting Started

Parameters

Parameter	Description
attributes	This parameter is used to set the Attributes
appNames	This parameter is used to set the list of apps you are retrieving a token for, such as card_balance or card_issuance
authType	This parameter is used to set the OAuth grant type. Valid values are client_credentials, password_credentials, client_token
basePath	This parameter is used to set the base path. Valid values are https://api.hydrogenplatform.com
accessToken	This parameter is used to pass in the JWT Access Token if you authenticate outside of the SDK
clientToken	This parameter is used to pass in the JWT Access Token for Custom Client Token apps if you authenticate outside of the SDK
clientId	This parameter is used to set your OAuth client_id to authenticate if you don't pass in the JWT Access Token
clientSecret	This Parameter is used to set your OAuth client_secret to authenticate if you don't pass in the JWT Access Token
username	This parameter is used to pass in the Nucleus Client username of the user to authenticate password grant apps
password	This parameter is used to pass in the Nucleus Client password of the user to authenticate password grant apps
isEmbed	This parameter is used to return an HTML embed code in the response, including all passed data attributes. Valid values are true or false

Sample Code

using System;
using IO.Swagger.Api;
using IO.Swagger.Model;
using System.Collections.Generic;
using Newtonsoft.Json;
namespace csharp_demo
{
    class Program
    {
        static void Main(string[] args)
        {
             AppTokenConfig appTokenConfig = new IO.Swagger.Model.AppTokenConfig();
             AppConfig appConfig = new IO.Swagger.Model.AppConfig();
             appConfig.appName = "card_issuance";
             TagAttributes tagAttributes = new IO.Swagger.Model.TagAttributes();
             tagAttributes.name = "client_id";
             tagAttributes.value = "client_id_value";
             appTokenConfig.basePath = "https://api.hydrogenplatform.com";
             appTokenConfig.clientId = "xxxxx";
             appTokenConfig.clientSecret = "xxxxx";
             appTokenConfig.authType = "client_credentials";
             appTokenConfig.appNames = new List<AppConfig>{appConfig};
             appTokenConfig.attributes = new List<TagAttributes>{tagAttributes};
             appTokenConfig.isEmbed = true;
             appTokenConfig.username = null;
             appTokenConfig.password = null;
             appTokenConfig.accessToken = "xxxx";
             appTokenConfig.clientToken = "xxxxx";
             appTokenConfig.isEmbed = true;

            var apiInstance = new AutoGenerateAppTokenApi(appTokenConfig);
            try
            {
                List<Dictionary<string, string>> result = apiInstance.GetAppTokenUsingGET();
                Console.WriteLine(JsonConvert.SerializeObject(result));

            }
            catch (Exception e)
            {
                Console.WriteLine("Exception when calling AutoGenerateAppTokenApi.GetAppTokenUsingGET: " + e);
            }

        }
    }
}

Author

The Hydrogen Technology Corporation

https://www.hydrogenplatform.com