mercadolibre

Mercadolibre SDK module for integration

MercadoLibreNode

MercadoLibreNode SDK for Node.js

npm install mercadolibre

var meli = require('mercadolibre');

####Constructor:

var meliObject = new meli.Meli(client_id, client_secret, [access_token], [refresh_token]);
FieldTypeRequiredDescription
client_idintyesID provided when creating a MELI APP (link to create app guide)
client_secretstringyesHash string key provided when creating a MELI APP (link to create app guide)
access_tokenstringoptionalUsed to talk to our API resources that require credentials (eg: POST to /items).
refresh_tokenstringoptionalHash string provided when a user authorizes an A P. Used to get a new valid access_token (only available when offline_access scope in APP settings is checked).
meliObject.getAuthURL(redirect_uri) 
FieldTypeRequiredDescription
redirect_uristringyesCallback URL to which the user will be redirected after granting permission to the Meli APP. The code required to obtain the first access_token (required in Authorize method) will be appended to this URL when making this redirect.
meliObject.authorize(code, redirect_uri, callback) 
FieldTypeRequiredDescription
codestringyesCode received at redirect_uri when user granted permission to the Meli APP.
redirect_uristringyesCallback URL to which the API will send the access & refresh tokens. Must be the same as the one configured in the Meli APP settings.
callbackfunctionyesCallback function is executed when the task is completed
meliObject.refreshAccessToken(callback) 
FieldTypeRequiredDescription
callbackfunctionyesCallback function is executed when the task is completed
meliObject.get(path, [params,] callback) 
FieldTypeRequiredDescription
pathstringyesAPI resource path to which the GET request will be sent to.
paramsobjectoptionalAdditional params (if required).
callbackfunctionyesCallback function is executed when the task is completed

post

meliObject.post(path, body, [params,] callback) 
FieldTypeRequiredDescription
pathstringyesAPI resource path to which the GET request will be sent to.
bodyobjectyesBody to be sent when executing the POST request.
paramsobjectoptionalAdditional params (if required).
callbackfunctionyesCallback function is executed when the task is completed
meliObject.put(path, body, [params,] callback) 
FieldTypeRequiredDescription
pathstringyesAPI resource path to which the GET request will be sent to.
bodyobjectyesBody to be sent when executing the POST request.
paramsobjectoptionalAdditional params (if required).
callbackfunctionyesCallback function is executed when the task is completed
meliObject.delete(path, [params,] callback) 
FieldTypeRequiredDescription
pathstringyesAPI resource path to which the GET request will be sent to.
paramsobjectoptionalAdditional params (if required).
callbackfunctionyesCallback function is executed when the task is completed

The callback function, in all cases receives the parameters:

var exampleCallback = function(error, response){ }

The object passed in the params parameter in functions get, post, put and delete. Is automatically converted to a query string
Example:

meliObject.get('/users/', {ids: [77169310, 1231233]}, function(a,b) { })

The request is get ​​to the following address:

https://api.mercadolibre.com/users/?ids=77169310,1231233