README

这是MercadoLibre平台的官方PHP SDK。

如何安装它？

$ composer require idealizetecnologia/meli
$ composer dumpautoload -o // optional

如何使用它？

首先，实例化一个 Meli 类。您需要提供一个 clientId 和一个 clientSecret。您可以在创建自己的应用程序后获取这两个值。有关更多信息，请参阅：[创建应用程序](http://developers.mercadolibre.com/application-manager/)

包含库

将meli库包含到您的项目中

<?php

require 'vendor/autoload.php';

use \Meli\Meli;

开始开发！

创建Meli类的实例

就像这样简单

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

有了这个实例，您就可以开始使用MercadoLibre的API了。

有一些设计考虑因素值得提及。

1. 此SDK只是http客户端上的一层薄层，为您处理所有的OAuth WebServer流程。

2. 有JSON解析。此SDK将包含json以供内部使用。

3. 此SDK将包含curl以供内部使用。

4. 如果您已经拥有了access_token和refresh_token，可以在构造函数中传递

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

如何将用户重定向到授权我的应用程序？

这是一个两步的过程。

首先获取重定向用户的链接。这很简单！只需

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

这将给出重定向用户的URL。您需要指定一个回调URL，这是用户成功授权过程后的重定向URL。

一旦用户被重定向到您的回调URL，您将在查询字符串中接收到一个名为code的参数。您需要这个参数来完成第二个步骤。

$user = $meli->authorize($_GET['code'], 'http://somecallbackurl');

这将为您和您的用户获取access_token和refresh_token（如果您的应用程序有offline_access）。

在这个阶段，您已经准备好代表用户调用API了。

执行GET调用

$params = ['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); 

执行POST调用

$params = ['access_token' => $access_token];

  #this body will be converted into json for you
$body = ['foo' => 'bar', 'bar' => 'foo'];

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

执行PUT调用

$params = ['access_token' => $access_token];

  #this body will be converted into json for you
$body = ['foo' => 'bar', 'bar' => 'foo'];

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

执行DELETE调用

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

示例

不要忘记查看我们在文件夹examples中的示例代码。

社区

如果您有任何问题，可以通过在开发者网站中描述的标准通信渠道联系我们。

我想贡献！

太好了！只需在GitHub上fork项目。创建一个分支，编写一些代码，并为您的代码添加一些测试。

感谢您的帮助！