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