winkelco/mercadolibre-api

MercadoLibre API 客户端

1.1 2021-02-17 17:01 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 winkelco/mercadolibre-api

使用方法

<?php

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

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

var_dump($ml_response);

// object(Winkelco\MercadoLibreApi\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 关联的品牌。official_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

    通过 App 获取通知历史。

类别与列表

  • /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和category_id搜索类别中的项目。GET

    按seller id和cateogyr 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搜索商品。通过状态过滤商品。