vcoud/mercadolibre

Mercadolibre SDK Composer Package

, _(*1)

MercadoLibre's PHP SDK Composer Package

This is a fork of MercadoLibre's PHP Sdk, we only make it easy to implement on laravel projects, _(*2)

How do I install it?

   composer require vcoud/mercadolibre

How do I use it?

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, _(*3)

Create an instance of Meli class

Simple like this, _(*4)

use Vcoud\Mercadolibre\Meli;

$meli = new Meli('1234', 'a secret');

With this instance you can start working on MercadoLibre's APIs., _(*5)

There are some design considerations worth to mention., _(*6)

1. This SDK is just a thin layer on top of an http client to handle all the OAuth WebServer flow for you., _(*7)

2. There is JSON parsing. this SDK will include json for internal usage., _(*8)

3. This SDK will include curl for internal usage., _(*9)

4. If you already have the access_token and the refresh_token you can pass in the constructor, _(*10)

$meli = new Meli('1234', 'a secret', 'Access_Token', 'Refresh_Token');

How do I redirect users to authorize my application?

This is a 2 step process., _(*11)

First get the link to redirect the user. This is very easy! Just:, _(*12)

$redirectUrl = $meli->getAuthUrl("http://somecallbackurl",Meli::$AUTH_URL['MLB']); //  Don't forget to set the autentication URL of your country.

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., _(*13)

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., _(*14)

$user = $meli->authorize($_GET['code'], 'http://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., _(*15)

At this stage your are ready to make call to the API on behalf of the user., _(*16)

Making GET calls

$params = array('access_token' => $access_token);
$result = $meli->get('/users/me', $params); 
 #If you wish , you can get an associative array with param $assoc = true Example:
$result = $meli->get('/users/me', $params, true); 

Making POST calls

$params = array('access_token' => $access_token);

  #this body will be converted into json for you
$body = array('foo' => 'bar', 'bar' => 'foo');

$response = $meli->post('/items', $body, $params);

Making PUT calls

$params = array('access_token' => $access_token);

  #this body will be converted into json for you
$body = array('foo' => 'bar', 'bar' => 'foo');

$response = $meli->put('/items', $body, $params);

Making DELETE calls

$params = array('access_token' => $access_token);
$response = $meli->delete('/questions/123', $params)