README

MercadoLibre 的 PHP SDK

这是 MercadoLibre 平台的官方 PHP SDK。

如何安装它？

   composer require facuramirez7/mercadoLibre-php-sdk

如何使用它？

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

包含库

在您的项目中包含 meli 库

require '/Meli/meli.php';

开始开发！

创建 Meli 类的实例

非常简单，就像这样

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

使用此实例，您可以开始使用 MercadoLibre 的 API。

有一些设计考虑事项值得提及。

此 SDK 是在 http 客户端之上的一层薄层，用于处理所有 OAuth WebServer 流程。
存在 JSON 解析。此 SDK 将包含 json 以供内部使用。
此 SDK 将包含 curl 以供内部使用。
如果您已经拥有 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 change the $AUTH_URL value to match your user's Site Id.

这将给出用户重定向的 URL。您需要指定一个回调 URL，用户在授权流程成功后将被重定向到该 URL。

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

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

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

在这个阶段，您可以代表用户调用 API。

执行 GET 调用

$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);

执行 POST 调用

$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);

执行 PUT 调用

$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);

执行 DELETE 调用

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

示例

别忘了查看我们文件夹 examples 中的示例代码

社区

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

我想贡献！

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

感谢您的帮助！

facuramirez / mercado-libre-php-sdk

维护者

详细信息