README

MercadoLibre的PHP SDK

这是MercadoLibre平台官方的PHP SDK。

如何安装它？

   clone repository
   https://github.com/mercadolibre/php-sdk.git

如何使用它？

首先，实例化一个Meli类。你需要提供一个clientId和一个clientSecret。你可以在创建自己的应用程序后获得这两个值。有关更多信息，请参阅：创建应用程序

包含库

将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项目。创建一个分支，编写一些代码，并为你的新代码添加一些测试。

感谢你的帮助！

melibox / mercadolibre-php-sdk

维护者

详细信息