winkelco / mercadolibre-api
MercadoLibre API 客户端
Requires
- guzzlehttp/guzzle: ~5.0|~6.0|~7.0
- jms/serializer: ^1.3|^3.11
- symfony/yaml: ~2.1|~3.0|~5.0
Requires (Dev)
- phpunit/phpunit: ^5.5|^9.0
README
文档
官方文档和如何使用 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搜索商品。通过状态过滤商品。