CMS365.EbaySharp 1.0.6

EbaySharp: A .NET wrapper library for eBay REST API.

EbaySharp is a .NET library that enables you to authenticate and make REST API calls to eBay. It's used for creating listings and managing orders using C# and .NET

Installation

EbaySharp is available on NuGet. Use the package manager console in Visual Studio to install it:

Install-Package CMS365.EbaySharp

API support

EbaySharp currently supports the following Ebay REST APIs:

• Access and Security
  • Getting a user access token
• Using the EbaySharp
  • Using the EbaySharp
  • Sell
    • Inventory
      • Listing
        • Bulk migrate listings
    • Metadata
      • Marketplace
        • Get return policies
  • Commerce
    • Taxonomy
      • Category Tree
        • Get default category tree id
        • Get category suggestions
        • Get category tree

Access and Security

Create an account here https://developer.ebay.com/my/keys and generate keys for production.

For example:

Navigate to user tokens https://developer.ebay.com/my/auth/?env=production&index=0 and select following options.

From the same page, generate the ebay redirect URL (called RU)

Copy the URL of the field "Your branded eBay Production Sign In (OAuth)" and open in a new browser in private mode and also save a copy of the URL for future use. Log in with your store user id and password and you will be redirected to the following page

Copy the URL of the thank you page and assign it to a variable called "secureURL" and execute the following function.

public async Task<string> GetRefreshTokenAsync()
{
    string secureURL="repalce with the url of the thank you page";
    EbaySharp.Controllers.IdentityController identityController = new EbaySharp.Controllers.IdentityController();
    string refreshToken = await identityController.GetRefreshTokenAsync(ReplaceYourClientID, ReplaceYourClientSecret, 
        , secureURL, Replace with RU);
}

This method returns a refresh token whcih is valid for 18 months. You will need to re run this function after 18 months when refresh token has expired. We will use the refresh token and generate an access token.

IdentityController identityController=new IdentityController();
var clientCredentials = await identityController.GetClientCredentials(ReplaceYourClientID, ReplaceYourClientSecret, ReplaceWithRefreshToken , ReplaceWithScopes);

This method now gives you ClientCredentialsResponse object which contains an access token.

Using the EbaySharp

Initialize the instance with the access token.

EbayController ebayController = new EbayController(clientCredentials.AccessToken);

Sell

Inventory

You can see a list of Inventory methods here https://developer.ebay.com/api-docs/sell/inventory/resources/methods

Listing

Bulk migrate listings

If you have already created your listing using old API (for example .NET C# SDK), you will need to migrate all listing to new REST API.

BulkMigrateListingRequest bulkMigrateListingRequest = new BulkMigrateListingRequest()
{
    Requests = new BulkMigrateListingRequestItem[]
    {
        new BulkMigrateListingRequestItem(){ListingID = "Replace with item number" },
        new BulkMigrateListingRequestItem(){ListingID = "Replace with item number" }
    }
});
EbaySharp.Controllers.EbayController ebayController = new EbaySharp.Controllers.EbayController(clientCredentials.AccessToken);
BulkMigrateListingResponse bulkMigrateListingResponse = await ebayController.BulkMigrateAsync(bulkMigrateListingRequest);

Metadata

You can see a list of Metadata methods here https://developer.ebay.com/api-docs/sell/metadata/resources/methods

Marketplace

Get return policies

ReturnPoliciesResponse returnPoliciesResponse = await ebayController.GetReturnPoliciesAsync([MarketplaceID]);

You need to pass MarketplaceID, please visit https://developer.ebay.com/api-docs/commerce/taxonomy/static/supportedmarketplaces.html for supported market places.

Commerce

Taxonomy

You can see a list of Taxonomy methods here https://developer.ebay.com/api-docs/commerce/taxonomy/resources/methods

Category Tree

Get default category tree id

CategoryTreeIDResponse categoryTreeIDResponse = await ebayController.GetDefaultCategoryTreeIDAsync([MarketplaceID]);

You need to pass MarketplaceID, please visit https://developer.ebay.com/api-docs/commerce/taxonomy/static/supportedmarketplaces.html for supported market places.

Get category suggestions

CategorySuggestionsResponse categorySuggestionsResponse = await ebayController.GetCategorySuggestionsAsync([CategoryTreeID], [ProductTitle]);

You need to pass a Category Tree ID and the product title you are searching categories for.

Get category tree

CategoryTreeResponse categorySuggestionsResponse = await ebayController.GetCategoryTreeAsync([CategoryTreeID]);

You need to pass a Category Tree ID.