zephia/mercadolibre

Mercado Libre API 客户端

v0.1.12 2016-12-21 21:56 UTC

README

Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Total Downloads License

文档

官方文档和如何使用 MercadoLibre API 可以在 http://developers.mercadolibre.com/api-docs/ 找到

安装

使用 composer

composer require zephia/mercadolibre

用法

<?php

// Instantiate serializer with configurations.
$serializer = \JMS\Serializer\SerializerBuilder::create()
   ->addMetadataDir(__DIR__ . '/../../resources/config/serializer')
   ->build();
   
// Instantiate client.
$client = new Zephia\MercadoLibre\Client\MercadoLibreClient(
    [],
    $serializer
);

// Call show user.
$ml_response = $client->showUser(1);

var_dump($ml_response);

// object(Zephia\MercadoLibre\Entity\User)

MercadoLibre API 资源

已删除的资源在此包中尚不可用。欢迎贡献。

用户 & 应用

  • /users/{Cust_id}?access_token=$ACCESS_TOKEN 用户账户信息。GET PUT

    获取用户信息。

    $client->userShow('123');

    更新用户信息

  • /users/me 返回认证用户的账户信息。GET

    获取认证用户信息。

    $client->userShowMe();
  • /users/{Cust_id}/addresses?access_token=$ACCESS_TOKEN 返回用户注册的地址。GET

    获取用户地址。

  • /users/{Cust_id}/accepted_payment_methods 返回卖家接受的支付方式。GET

    获取用户接受的支付方式。

  • /applications/{application_id}?ACCESS_TOKEN 返回应用程序信息。GET

    获取应用程序详情。

  • /users/{User_id}/brands 此资源检索与 user_id 关联的品牌。官方_store_id 属性标识一个商店。GET

    通过用户获取品牌。

  • /users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN 管理用户推广包。GET POST

    获取用户参与的推广包。

    $client->userPackages();

    为用户创建一个新的推广包。

  • /users/{user_id}/classifieds_promotion_packs/{listing_type}&categoryId={category_id}?acces_token=$ACCESS_TOKEN 根据参与的包,用户可以在给定的列表类型和类别下列出。GET

    获取用户和类别的可用列表类型。

  • /projects?access_token=$ACCESS_TOKEN 管理项目。GET POST PUT DELETE

    获取与项目关联的所有应用程序。

    创建一个新的项目。

    更新项目。

    删除项目。

  • /projects/{Project_id}/applications?access_token=ACCESS_TOKEN_APP_OWNER 管理应用程序 & 项目。POST DELETE

    在您的项目中保存一个应用程序。

    从您的项目中删除一个应用程序。

  • /users/{Cust_id}/available_listing_types?category_id={Category_id}&access_token=$ACCESS_TOKEN 用户和类别的可用列表类型。GET

    获取可用列表类型。

  • /users/{Cust_id}/available_listing_type/{listing_type_id}?category_id={Category_id}&access_token=$ACCESS_TOKEN 获取给定类别下列表类型的可用性。GET

    获取类别可用性。

  • /users/{User_id}/applications/{App_id}?access_token=$ACCESS_TOKEN 应用程序权限。DELETE

    撤销应用程序的权限。

  • /myfeeds?app_id={App_id} 通知历史记录。GET

    通过应用程序获取通知历史。

类别 & 列表

  • /sites 获取 MercadoLibre 运行的站点信息。GET

    获取所有站点。

  • /site_domains/{Site_domain_url} 返回关于域的信息。GET

    获取域名信息。

  • /sites/{Site_id}/listing_types 返回关于列表类型的信息。GET

    通过站点获取列表类型。

  • /sites/{Site_id}/listing_exposures 返回与 MercadoLibre 中所有列表类型相关联的不同曝光级别。GET

    通过站点获取列表曝光。

  • /sites/{Site_id}/listing_prices?price={Price} 返回在 MercadoLibre 中买卖的列表价格。GET

    获取商品列表价格。

  • /sites/{Site_id}/categories 返回网站上的可用类别。GET

    按网站获取类别树。

    $client->categoryList();
  • /categories/{Category_id} 返回有关类别的信息。GET

    获取类别详细信息。

  • /categories/{Category_id}/attributes 显示属性及其规则,以便描述每个类别中存储的项目。GET

    获取类别属性。

  • /sites/{Site_id}/category_predictor/predict 类别预测器。根据标题检索最准确的类别来列出您的商品。GET

    预测类别。

    $client->categoryPredict('MLA', 'Fiat Uno');
  • /categories/{Category_id}/classifieds_promotion_packs 按类别检索分类推广套餐。GET

    按类别获取分类推广套餐。

位置与货币

  • /countries 返回国家信息。GET

    获取国家信息。

  • /countries/{Country_id} 根据country_id返回国家信息。GET

    获取国家详情

  • /states/{State_id} 返回州信息。GET

    获取州信息。

  • /cities/{City_id} 返回城市信息。GET

    获取城市信息。

  • /currencies 返回MercadoLibre中所有可用货币的信息。GET

    获取货币信息。

  • /currencies/{Currency_id} 根据currency_id返回MercadoLibre中可用货币的信息。GET

    获取货币详情。

  • /currency_conversions/search?from={Currency_id}&to={Currency_id} 检索MercadoLibre在计算中使用的货币之间的转换率。GET

    获取货币间的转换率。

  • /countries/{Country_id}/zip_codes/{Zip_code} 检索输入的邮编所在位置的数据。GET

    通过邮编获取位置信息。

  • /country/{Country_id}/zip_codes/search_between?zip_code_from={zip_code_from}&zip_code_to={zip_code_to} 获取两个给定邮编之间的所有邮编。GET

    获取两个给定邮编值之间的所有邮编。

商品与搜索

  • /items 允许列出商品。POST

    在MercadoLibre上列出商品。

    $item = new Zephia\MercadoLibre\Entity\Item;
    $client->itemCreate($item);
  • /items/{Item_id} 允许管理商品列表 GET PUT

    获取商品详情。

    $client->itemShow('MLA123123');

    更新商品。

  • /items/validate 在发布商品前验证JSON。POST

    验证您的JSON。

  • /items/{Item_id}/available_upgrades 返回可用的商品升级类型。GET

    获取可用的升级。

  • /items/{Item_id}/relist 允许重新列出商品。GET

    重新列出您的商品。

  • /items/{Item_id}/pictures/{picture_id} 管理商品图片。GET DELETE

    获取所有尺寸的图片。

    删除图片。

  • /items/{Item_id}/pictures 在您的商品上添加和更新图片。GET PUT

    发布图片。

    更新商品图片。

  • /items/{Item_id}/description 管理商品的描述。GET PUT

    获取商品描述。

    更新商品描述。

  • /sites/{Site_id}/search?q=ipod 根据搜索查询检索商品。GET

    方法描述

  • /sites/{Site_id}/searchUrl?q=ipod 在MercadoLibre中搜索任何商品。它将返回匹配搜索条件的商品URL数组。GET

    根据查询搜索商品URL。

  • /sites/MLA/search?category={Category_id}&official_store_id=all 搜索给定类别所有官方商店列出的商品。GET

    搜索官方商店商品。

  • /sites/{Site_id}/hot_items/search?limit=5&category={Category_id} 通过参数检索指定类别的热门商品数组。仅适用于第一级类别。GET

    搜索热门商品。

  • /sites/{Site_id}/featured_items/HP-{Category_Id} 检索商品数组的特色商品。特色商品是在主页或类别页面上具有特殊展示位置的商品。您可以使用HP用于产品的主页或HP-{categId}用于按类别特色。仅适用于第一级类别。GET

    按其类别获取主页上的特色商品。

  • /sites/{Site_id}/trends/search?category={Category_id} 通过参数指定的类别获取趋势项的数组。GET

    按类别获取趋势

  • /sites/{Site_id}/search?seller_id={Seller_id}&category={Category_id}&access_token=$ACCESS_TOKEN 按seller_id搜索某一类别的商品。GET

    通过seller id和类别id获取商品。

  • /users/{Cust_id}/items/search?access_token=$ACCESS_TOKEN 获取用户的商品列表。GET

    获取用户的商品列表

    $client->setAccessToken(ACCESS_TOKEN)->itemList('user_id');
  • /items/{Item_id}/product_identifiers/ 获取与您的商品关联的产品标识码。GET PUT

    获取商品产品标识。

    更新产品标识

  • /items/{Item_id}/variations 管理商品的变体。GET POST

    获取商品的变体。

    为您的商品创建一个变体。

  • /items/{Item_id}/variations/{Variation_id} 管理变体。GET PUT DELETE

    获取变体详情。

    更新一个变体。

    删除一个变体。

  • /users/{Cust_id}/items/search?sku={seller_custom_field}&status=active&access_token=$ACCESS_TOKEN 通过SKU搜索商品。通过状态过滤商品。GET

    通过SKU搜索商品。通过状态过滤商品。