有赞 API PHP SDK

有赞API 的PHP实现, 对有赞官方提供的 KdtApiClient 的进一步封装

通讯协议

目前仅支持 AppId / AppSecret 签名通讯协议 适用于：个人开发者、单店铺开发者

已实现接口

商品接口 kdt.item.add 新增一个商品 kdt.item.delete 删除一个商品 kdt.item.get 得到单个商品信息 kdt.item.sku.update 更新SKU信息 kdt.item.update 更新单个商品信息 kdt.item.update.delisting 商品下架 kdt.item.update.listing 商品上架 kdt.items.custom.get 根据商品货号获取商品 kdt.items.inventory.get 获取仓库中的商品列表 kdt.items.onsale.get 获取出售中的商品列表 kdt.skus.custom.get 根据外部编号取商品Sku kdt.items.update.delisting 批量下架商品 kdt.items.update.listing 批量上架商品

商品类目接口 kdt.itemcategories.get 获取商品分类二维列表 kdt.itemcategories.promotions.get 获取商品推广栏目列表 kdt.itemcategories.tags.get 获取商品自定义标签列表 kdt.itemcategories.tags.getpage 分页获取商品自定义标签列表

物流接口 kdt.logistics.online.confirm 卖家确认发货 kdt.logistics.online.marksign 卖家标记签收 kdt.logistics.trace.search 物流流转信息查询

店铺接口 kdt.shop.basic.get 获取店铺基本信息

交易接口 kdt.trade.close 卖家关闭一笔交易 kdt.trade.get 获取单笔交易的信息 kdt.trade.memo.update 修改一笔交易备注 kdt.trades.sold.get 查询卖家已卖出的交易列表

工具接口 kdt.regions.get 获取区域地名列表信息

安装（Composer）

composer require ckoo/youzan-sdk

依赖

"symfony/filesystem": "~2.8.0", "netresearch/jsonmapper": "0.10.*"

使用方法

初始化

AppId: 店铺的AppId(应用ID) AppSecret: 店铺的AppSecret(应用密钥) CacheDIR: 文件缓存目录 use YouzanYouzan; $youzan = new Youzan(AppId, AppSecret, CacheDIR); $youzan->goods(); // 获取商品操作类 GoodsService $youzan->trade(); // 获取订单操作类 TradeService $youzan->itemcategory(); // 获取商品类目操作类 ItemcategoryService $youzan->logistics(); // 获取物流操作类 ItemcategoryService $youzan->shop(); // 获取店铺操作类 ShopService

操作商品

/** * 获取商品列表 */ $service = $youzan->goods(); list($items, $total) = $service->itemsOnsaleGet(); /** * 添加商品 */ use YouzanServiceParametersGoodsParamters; // 创建商品参数对象 $parameters = new GoodsParamters(); $parameters->title = '测试商品标题'; $parameters->price = '999.00'; $parameters->images = array( 'http://img.58codes.com/202401/pihvioeo3vv2855.jpg', 'http://img.58codes.com/202401/vffwtmpilyy2856.jpg', '/path/xxxx/images/ccc.jpg' ); // 添加商品 $item = $service->itemAdd($parameters);

操作订单

/** * 获取订单列表 */ use YouzanModelTradeStatus $service = $youzan->trade(); list($result, $total) = $service->tradesSoldGet(TradeStatus::WAIT_BUYER_CONFIRM_GOODS);

操作订单

/** * 上一次API请求的错误信息 */ $error = $service->getLastError();