Merge pull request #558 from mbradley672/melvin/HTTP_proxy_sample_code_and_documentation

Proxy/GetOrderAddress sample code and documentation

Author: abuzuhri

README.md

@@ -97,7 +97,10 @@ For more information about keys please check [New Amazon doc for create keys Dev
 ---
 ## Usage
 
+> ### Please be aware there has been a change to the _Orders.GetOrderAddress()_ method please reference the new sample code for more details.
+
 ### Configuration
+You can configure a connection like so please see [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/Program.cs) for the relevant code file.
 ```CSharp
 AmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()
 {
@@ -125,6 +128,25 @@ AmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()
 
 ```
 
+### Configuration using a proxy
+Please see [here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/Program.cs) for the relevant code file.
+>```csharp
+>AmazonConnection amazonConnection = new AmazonConnection(new AmazonCredential()
+>{
+>     AccessKey = "AKIAXXXXXXXXXXXXXXX",
+>     SecretKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+>     RoleArn = "arn:aws:iam::XXXXXXXXXXXXX:role/XXXXXXXXXXXX",
+>     ClientId = "amzn1.application-XXX-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+>     ClientSecret = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+>     RefreshToken= "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+>     MarketPlaceID = "A2VIGQ35RCS4UG",
+>     ProxyAddress = "http(s)://xxx.xxx.xxx.xxx:xxxx",
+>});
+>```
+>> * Assign your proxy address to the ProxyAddress Property and you'll be able to use a proxy account. 
+>>
+>> ***This is not required and will operate normally without the ProxyAddress being set.***
+
 ### Order List, For more orders sample please check [Here](https://github.com/abuzuhri/Amazon-SP-API-CSharp/blob/main/Source/FikaAmazonAPI.SampleCode/ReportsSample.cs).
 ```CSharp
 ParameterOrderList serachOrderList = new ParameterOrderList();

Source/FikaAmazonAPI.SampleCode/OrdersSample.cs

@@ -102,7 +102,13 @@ public void GetOrderBuyerInfo()
 
         public void GetOrderAddress()
         {
+            // This method has been changed and is a breaking change
+            // If you would like the default behavior please reference the 
+            // ShippingAddress variable
             var Address = amazonConnection.Orders.GetOrderAddress("402-0467973-4229120");
+            var BuyerCompanyName = Address.BuyerCompanyName;
+            var ShippingAddress = Address.ShippingAddress;
+            var DeliveryPreferences = Address.DeliveryPreferences;
         }
 
 

Source/FikaAmazonAPI.SampleCode/Program.cs

@@ -27,6 +27,20 @@ static async Task Main(string[] args)
                 SellerID = config.GetSection("FikaAmazonAPI:SellerId").Value,
                 IsDebugMode = true
             });
+            
+            AmazonConnection amazonConnectionUsingAProxy = new AmazonConnection(new AmazonCredential()
+            {
+                AccessKey = config.GetSection("FikaAmazonAPI:AccessKey").Value,
+                SecretKey = config.GetSection("FikaAmazonAPI:SecretKey").Value,
+                RoleArn = config.GetSection("FikaAmazonAPI:RoleArn").Value,
+                ClientId = config.GetSection("FikaAmazonAPI:ClientId").Value,
+                ClientSecret = config.GetSection("FikaAmazonAPI:ClientSecret").Value,
+                RefreshToken = config.GetSection("FikaAmazonAPI:RefreshToken").Value,
+                MarketPlaceID = config.GetSection("FikaAmazonAPI:MarketPlaceID").Value,
+                SellerID = config.GetSection("FikaAmazonAPI:SellerId").Value,
+                IsDebugMode = true,
+                ProxyAddress = config.GetSection("FikaAmazonAPI:ProxyAddress").Value,
+            });
 
             var search = amazonConnection.ProductType.SearchDefinitionsProductTypes(new Parameter.ProductTypes.SearchDefinitionsProductTypesParameter
             {

Source/FikaAmazonAPI.SampleCode/appsettings.json

@@ -6,6 +6,7 @@
     "ClientId": "amzn1.application-oa2-client.0000000000000000000000000000",
     "ClientSecret": "000000000000000000000000000000000000",
     "RefreshToken": "Atzr|00000000000000000000000000000000000000000000",
-    "MarketPlaceID": "A2VIGQ35RCS4UG"
+    "MarketPlaceID": "A2VIGQ35RCS4UG",
+    "ProxyAddress": "http://localhost:8080",
   }
 }