This is the official Ruby SDK for MercadoLibre's Platform.
clone repository
https://github.com/mercadolibre/ruby-sdk.git
Add it to your Gemfile:
gem 'meli', '~> 0.0.1'
And then install
bundle install
The first thing to do is to instance a Meli
class. You'll need to give a clientId
and a clientSecret
. You can obtain both after creating your own application. For more information on this please read: creating an application
Include the lib meli in your project
Don't forget to set the authentication URL of your country in file lib/config.yml
require 'lib/meli'
Start the development!
Simple like this
meli = Meli.new(1234, "a secret")
With this instance you can start working on MercadoLibre's APIs.
There are some design considerations worth to mention.
-
This SDK is just a thin layer on top of an http client to handle all the OAuth WebServer flow for you.
-
There is JSON parsing. this SDK will include json gem for internal usage.
-
If you already have the access_token and the refresh_token you can pass in the constructor
meli = Meli.new(1234, "a secret", "Access_Token", "Refresh_Token")
This is a 2 step process.
First get the link to redirect the user. This is very easy! Just:
redirect_url = meli.auth_url("http:https://somecallbackurl", "AR")
This will give you the url to redirect the user. You need to specify a callback url which will be the one that the user will redirected after a successfull authrization process.
The country code param ("AR"
) is optional, it’s set to "BR"
by default. Take into account that if you don’t specify this, it will only work if your MercadoLibre app is from Brazil.
Once the user is redirected to your callback url, you'll receive in the query string, a parameter named code
. You'll need this for the second part of the process.
meli.authorize("the received code", "http:https://somecallbackurl")
This will get an access_token
and a refresh_token
(is case your application has the offline_access
) for your application and your user.
At this stage your are ready to make call to the API on behalf of the user.
params = {:access_token => meli.access_token}
response = meli.get("/users/me", params)
The response body will not be converted from json to Ruby hash
Look this simple way to resolve this:
#convert json into a ruby hash
resp_hash = JSON.parse response.body
puts resp_hahs["KEY"]
params = {:access_token => meli.access_token}
#we are cool, the sdk will convert this body into json for you
body = {:foo => "bar", :bar => "foo"}
response = meli.post("/items", body, params)
params = {:access_token => meli.access_token}
#we are cool, the sdk will convert this body into json for you
body = {:foo => "bar", :bar => "foo"}
response = meli.put("/items/123", body, params)
params = {:access_token => meli.access_token}
response = meli.delete("/questions/123", params)
Don't forget to check out our examples codes in the folder examples
You can contact us if you have questions using the standard communication channels described in the developer's site
That is great! Just fork the project in github. Create a topic branch, write some code, and add some tests for your new code.
Thanks for helping!