alejoasotelo/mercadolibre-php-sdk

Fork de la libreria php-sdk de MercadoLibre

MercadoLibre's PHP SDK

This is the official PHP SDK for MercadoLibre's Platform.

, _(*1)

, _(*2)

How do I install it?

   composer require alejoasotelo/mercadolibre-php-sdk

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)

Including the Lib

Include the lib meli in your project, _(*4)

require '/Meli/meli.php';

Start the development!, _(*5)

Create an instance of Meli class

Simple like this, _(*6)

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

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

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

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

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

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

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

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

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

$redirectUrl = $meli->getAuthUrl("http://somecallbackurl",Meli::$AUTH_URL['MLB']); //  Don't forget to change the $AUTH_URL value to match your user's Site Id.

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

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

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

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

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)

Examples

Don't forget to check out our examples codes in the folder examples, _(*19)

Community

You can contact us if you have questions using the standard communication channels described in the developer's site, _(*20)

I want to contribute!

That is great! Just fork the project in github. Create a topic branch, write some code, and add some tests for your new code., _(*21)

Thanks for helping!, _(*22)