README.md

[DEPRECATED] This repository is no longer maintained

From the first week of April 2021 we will stop maintaining our SDKs.

This project is not functional, the dependencies will not be updated to latest ones.

We recommend you read our documentation.

---

MercadoLibre's .Net SDK

This is the official .Net SDK for MercadoLibre's Platform.[Beta]

Frameworks supported

• .NET Core >=1.0
• .NET Framework >=4.6
• Mono/Xamarin >=vNext

Dependencies

• RestSharp - 106.10.1 or later
• Json.NET - 12.0.1 or later
• JsonSubTypes - 1.5.2 or later
• System.ComponentModel.Annotations - 4.5.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
Install-Package System.ComponentModel.Annotations

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

Installation

Generate the DLL using your preferred tool (e.g. dotnet build)

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

using MeliLibTools.MeliLibApi;
using MeliLibTools.Client;
using MeliLibTools.Model;

Getting Started

using System.Collections.Generic;
using System.Diagnostics;
using MeliLibTools.MeliLibApi;
using MeliLibTools.Client;
using MeliLibTools.Model;

namespace Example
{
    public class Example
    {
        public static void Main()
        {

            Configuration config = new Configuration();
            config.BasePath = "https://api.mercadolibre.com";
            var apiInstance = new CategoriesApi(config);
            var categoryId = categoryId_example;  // string |

            try
            {
                // Return by category.
                apiInstance.CategoriesCategoryIdGet(categoryId);
            }
            catch (ApiException e)
            {
                Debug.Print("Exception when calling CategoriesApi.CategoriesCategoryIdGet: " + e.Message );
                Debug.Print("Status Code: "+ e.ErrorCode);
                Debug.Print(e.StackTrace);
            }

        }
    }
}

Documentation for API Endpoints

All URIs are relative to https://api.mercadolibre.com

Class	Method	HTTP request	Description
CategoriesApi	CategoriesCategoryIdGet	GET /categories/{category_id}	Return by category.
CategoriesApi	SitesSiteIdCategoriesGet	GET /sites/{site_id}/categories	Return a categories by site.
CategoriesApi	SitesSiteIdDomainDiscoverySearchGet	GET /sites/{site_id}/domain_discovery/search	Predictor
ItemsApi	ItemsIdGet	GET /items/{id}	Return a Item.
ItemsApi	ItemsIdPut	PUT /items/{id}	Update a Item.
ItemsApi	ItemsPost	POST /items	Create a Item.
ItemsHealthApi	ItemsIdHealthActionsGet	GET /items/{id}/health/actions	Return item health actions by id.
ItemsHealthApi	ItemsIdHealthGet	GET /items/{id}/health	Return health by id.
ItemsHealthApi	SitesSiteIdHealthLevelsGet	GET /sites/{site_id}/health_levels	Return health levels.
OAuth20Api	Auth	GET /authorization	Authentication Endpoint
OAuth20Api	GetToken	POST /oauth/token	Request Access Token

Documentation for Models

• Model.Attributes
• Model.AttributesValueStruct
• Model.AttributesValues
• Model.Item
• Model.ItemPictures
• Model.Token
• Model.Variations
• Model.VariationsAttributeCombinations

Documentation for Authorization

oAuth2AuthCode

• Type: OAuth
• Flow: accessCode
• Authorization URL: https://auth.mercadolibre.com.ar/authorization
• Scopes:
  • read: Grants read access
  • write: Grants write access
  • offline_access: Grants read and write access, and adds the possibility to get a refresh token and stay authenticated as the user.