mastercard mdes customer service net45 tutorial

.NET 4.5：MasterCard MDESカスタマーサービスと統合する方法は？

目次

• 概要
• 前提条件
• ステップ1：.NET 4.5 APIクライアントライブラリを生成します
• ステップ2：生成されたソリューションを開いて構築します
• ステップ3：ソリューションにコンソールアプリプロジェクトを追加する
• ステップ4：JSONを使用するためにApiclientを拡張します
• ステップ5：MDES検索APIにリクエストを送信します

概要

MasterCardは、サービスと統合するためのクライアントライブラリを提供しますが、.NETパッケージは.NETフレームワーク4.5をサポートしていません。

• C＃OAUTH1署名者LIBは.NET標準1.3（.NETフレームワーク4.6+）をサポートしています
• MasterCard CoreおよびMasterCard MDESカスタマーサービスSDKSサポート.NETフレームワーク4.6.1+

このチュートリアルでは、OpenAPIジェネレーターを使用してAPIクライアントライブラリを生成し、OAUTH1署名者LIBの.NET 4.5バージョンを使用してHTTP要求に署名することにより、.NET 4.5アプリからMasterCard MDESカスタマーサービスを消費する方法について説明します。

前提条件

1. MDESカスタマーサービスのドキュメントをお読みください
2. MDESカスタマーサービスOpenAPI仕様をダウンロードします
3. MasterCard Developers Portalにプロジェクトを設定し、MDESカスタマーサービスAPIを追加します。

4. OAUTH1署名者ライブラリの.NET 4.5バージョンをチェックアウトして構築する

ステップ1：.NET 4.5 APIクライアントライブラリを生成します

.NET 4.5 MDESカスタマーサービス用のクライアントライブラリは、次のコマンドを使用して生成できます。

java -jar openapi-generator-cli.jar generate -i mdes-customer-service-2.0.4.yaml -g csharp -c config.json -o mdes-customer-service-net45-tutorial

config.json：

{ 
    "targetFramework" : " v4.5 " ,
    "packageName" : " YourApp.MdesCustomerClient " 
}

参照：Openapiジェネレーター（実行可能ファイル）

ステップ2：生成されたソリューションを開いて構築します

1. MDES-Customer-Service-Net45-Tutorial/SRCフォルダーに移動します
2. condition = "Execists（ ' HintPath Condition="Exists('....packages')"を削除してプロジェクトファイル（.csproj）を修正します。

< Reference Include = " RestSharp " >
    < HintPath >....packagesRestSharp.105.1.0libnet45RestSharp.dll</ HintPath >
</ Reference >

3. yourapp.mdescustomerclient.slnを開きます
4. [ビルド]> [再構築]ソリューションをクリックします

ステップ3：ソリューションにコンソールアプリプロジェクトを追加する

1. [ファイル]> [新規]> [プロジェクト]をクリックしてください。
2. コンソールアプリ（.NETフレームワーク）を選択し、次のようにプロジェクトを構成します。

3. 参照を右クリックして、次の依存関係をYourApp.Consoleプロジェクトに追加します。
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll （.net 4.5バージョン）
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll （.net 4.5バージョン）
   • RestSharp.dll

ステップ4：JSONを使用するためにApiClientを拡張します

デフォルトでは、MDESカスタマーサービスは、生成されたコードがJSONが使用されることを期待している場合、XMLペイロードを受け入れて返送しています。

私たちがJSON InterceptRequest話すサービスを示すために、 YourApp.MdesCustomerClientプロジェクトで新しいクラスを作成します。

 using RestSharp ;

namespace YourApp . MdesCustomerClient . Client
{
    /// <summary>
    /// Extends the generated ApiClient class.
    /// </summary>
    public partial class ApiClient
    {
        /// <summary>
        /// Adds "Format=JSON" to the RestSharp request so that the service accepts and returns JSON instead of XML.
        /// </summary>
        partial void InterceptRequest ( IRestRequest request ) => request . AddQueryParameter ( "Format" , "JSON" ) ;
    }
} 

ステップ5：MDES検索APIにリクエストを送信します

1. 次のコードでプログラムを更新します。

 class Program
{
    static void Main ( string [ ] args )
    {
        // The request was aborted: Could not create SSL/TLS secure channel
        ServicePointManager . Expect100Continue = true ;
        ServicePointManager . SecurityProtocol = SecurityProtocolType . Tls12 ;

        var consumerKey = "<insert consumer key>" ;
        var signingKey = SecurityUtils . LoadPrivateKey ( "<insert PKCS#12 key file path>" , "<insert key alias>" , "<insert key password>" ) ; // Pass X509KeyStoragFlags here
        var config = Configuration . Default ;
        config . BasePath = "https://sandbox.api.mastercard.com/mdes/csapi/v2" ;
        config . ApiClient . RestClient . Authenticator = new RestSharpOAuth1Authenticator ( consumerKey , signingKey , new Uri ( config . BasePath ) ) ;
        var searchApi = new SearchApi ( config ) ;
        var auditInfo = new AuditInfo ( "A1435477" , "John Smith" , "Any Bank" , "5555551234" ) ;
        var tokenUniqueReference = "DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c" ;
        var searchRequest = new SearchRequest ( null , tokenUniqueReference , null , null , null , null , null , null , auditInfo ) ;
        var response = searchApi . SearchPost ( new SearchRequestSchema ( searchRequest ) ) ;
        System . Console . WriteLine ( response . SearchResponse . Accounts . Account [ 0 ] . Tokens . Token [ 0 ] ) ;
        System . Console . ReadLine ( ) ;
    }
}

2. 独自のconsumerKey 、 pkcs12KeyFilePath 、 signingKeyAlias 、 signingKeyAlias 、 keyStorageFlagsを使用してください。
3. [デバッグ]をクリックします
4. これに似た結果を得る必要があります。