Skip to content

poroburu/newegg-marketplace-sdk-dotnet

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Newegg Marketplace SDK for .Net

Newegg Marketplace SDK(C#) is a library to help .Net programmers easily integrate their application with the Newegg Marketplace API. Included are definitions for the data objects models to create the request and resolve the response. The logger and retry mechanism can be customized to your requirements.

To use the SDK to communicate with the Newegg API, you need to be a registered seller and have an 'API Key(Authorization)' and 'Secret Key'. Please visit Newegg Marketplace Seller Portal to request API credentials. Review the Seller Help Guide to learn about detailed instruction. Put this information into a JSON file and load the setting using the APIConfig.FromJsonFile method. Without the 'API Key(Authorization)' and 'Secret Key' you can run the test project in Simulation Mode. This is provided to help you understand the SDK before actual use.

The solution contains 2 library projects: Newegg.Marketplace.SDK.Base and Newegg.Marketplace.SDK. The first one is the framework of the SDK, and the second one is the business logic model and interface to various API. The code is based on .NET Standard 2.0, you can build it with .Net framework 4.6 or .Net Core 2.1.

Target Frameworks

  • .NET Standard 2.0
  • .NET Core 2.1
  • .NET Framework 4.6

Installation

The package is on Nuget. You can install it with the Nuget Package Manager, search for 'newegg.marketplace.sdk'. You can also install it with the following tools:    
  • Package Manager:
    Install-Package Newegg.Marketplace.SDK -Version <current version number>
  • .Net CLI
    Install-Package Newegg.Marketplace.SDK -Version <current version number>
  • PackageReference
    <PackageReference Include="Newegg.Marketplace.SDK" Version="<current version number>" />
  • Paket CLI
    paket add Newegg.Marketplace.SDK --version <current version number>

build

You can download the zip file and build it for your target frameworks(.Net framework4.6 or .Net core2.1). You can choose manually build it and link library from your project or direct include the project to your solution. We recommend using Visual Studio 2017 or later. You can choose to build it with the command following too.

  • To build
    dotnet build Newegg.Marketplace.SDK
  • Nuget library The library Dependents on 'Newtonsoft.Json(12.0.1)' and 'NLog(4.6.2)'.

Q&A

  • How to use the SDK?
  1. We recommed setting these infomation in a json file as below.
{    
  "SellerID": "****",
  "Credentials": {
    "Authorization": "********************************",
    "SecretKey": "*******-****-****-****-************"
  },
  "Connection": {
    "RequestTimeoutMs": 20000,
    "AttemptsTimes": 3,
    "RetryIntervalMs": 3000
  },
  "APIFormat": "XML",
  "Platform": "CAN"
}
  1. load the configuration to a APIConfig object.
APIConfig config = APIConfig.FromJsonFile(PathOfTheJSONConfigFile);
  1. Create a APIClient with the config.
APIClient client = new APIClient(config);
  1. Create the APICall object with the APIClien.
OrderCall ordercall = new OrderCall(client);
  1. Use the APICall object to call API.
var orderstatus = await ordercall.GetOrderStatus("105137040", 304);
  • What's the settings in the Config?

    • SellerID : The 4-character Seller ID. Required.
    • Credentials.Authorization: The API Key get from datafeeds@newegg.com. Required.
    • Credentials.SecretKey: The Secret Key get from datafeeds@newegg.com. Required.
    • Connection.RequestTimeoutMs: The number of milliseconds the system connection timed out. Optional, Default:10000.
    • Connection.AttemptsTimes: Number of retries after a failed connection. Optional, Default:3.
    • Connection.RetryIntervalMs: The number of milliseconds between retry attempts. Optional, Default:3000.
    • BaseUrl: The base url of the Newegg marketplace API. Optional, Default: "https://api.newegg.com/marketplace/"
    • APIFormat: Content type used to call API. The options are XML and Json. Optional, Default: XML.
    • Platform: The platfrom of seller: There are three options:
  • How to get the API key and Secret Key?

    1. Send the request to Datafeeds@newegg.com from the seller default email address.
    2. The message should include seller name or default email address. Newegg Marketplace team will process all requests in 24 hours. 
  • NLog configuration file location and how to customize log
    Please refer https://github.com/NLog/NLog/wiki/Configuration-file#configuration-file-locations

  • How to use the Mock model?
    Set the SimulationEnabled to be 'true' to the APIClient object.

fakeUSAClientXML = new APIClient(USA_Config_XML) { SimulationEnabled = true };

Modules

Item

Seller

Order

Shipping

Other

SBN

DataFeed

Report

RMA

About

Newegg Marketplace SDK .Net

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%