搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
a. 一次请求只能查询时间跨度为一天的增量交易记录,即end_modified - start_modified <= 1天。
b. 返回的数据结果是以订单的修改时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。
c. 返回的数据结果只包含了订单的部分数据,可通过taobao.trade.fullinfo.get获取订单详情。
前往测试
1.公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) 获取Key和secret测试 |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
2.请求参数
请求参数:api=
参数说明:其它参数:参考淘宝开放平台接口文档,与淘宝的参数一致 https://open.taobao.com/api.htm?docId=140&docType=2
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
api | String | 淘宝开放平台的接口名(如:taobao.picture.upload( 上传单张图片 )) | |
session | String | 授权换取的session_id | |
[其他参数] | String | 其它参数:参考淘宝开放平台接口文档,与淘宝的参数一致 https://open.taobao.com/api.htm?docId=140&docType=2 |
3.响应参数(详细可参考淘宝开放平台API文档)
4.请求示例Curl PHP PHPsdk JAVA C# Python
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String url = "https://wx19970108018/taobao/custom/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&method=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
5.相关业务涉及的接口也是一样的请求方式
订单接口列表:
(新)物流管理包
Taobao.delivery.template.get 获取用户指定运费模板信息
Taobao.delivery.templates.get 获取用户下所有模板
Taobao.delivery.template.delete 删除运费模板
Taobao.delivery.template.add 新增运费模板
Taobao.delivery.template.update 修改运费模板
Taobao.logistics.consign.resend 修改物流公司和运单号
AG退款流程接入
Taobao.nextone.logistics.warehouse.update AG退货入仓状态写接口
Taobao.rdc.aligenius.refunds.check 退款信息审核
Taobao.rdc.aligenius.sendgoods.cancel 取消发货
Taobao.rdc.aligenius.account.validate AG商家账号校验
Taobao.rdc.aligenius.warehouse.resend.logistics.msg.post 补发单物流信息回传
Taobao.rdc.aligenius.warehouse.resend.update 补发单状态回传
Taobao.rdc.aligenius.ordermsg.update 订单消息状态回传
Taobao.rdc.aligenius.warehouse.reverse.event.update 销退单事件回传接口
Taobao.rdc.aligenius.warehouse.reverse.uploading 销退单上传
Taobao.rdc.aligenius.identification.case.result.update 鉴定工单结果同步
Taobao.rdc.aligenius.identification.case.update 鉴定工单信息同步
物流基础信息查询
Taobao.areas.get 查询地址区域
Taobao.logistics.companies.get 查询物流公司信息
Taobao.logistics.partners.get 查询支持起始地到目的地范围的物流公司
卖家地址库管理
Taobao.logistics.address.search 查询卖家地址库
Taobao.logistics.address.remove 删除卖家地址库
Taobao.logistics.address.modify 卖家地址库修改
Taobao.logistics.address.add 卖家地址库新增接口
Taobao.logistics.address.reachable 判定服务是否可达
Taobao.logistics.address.reachablebatch.get 批量判定服务是否可达
商品类目属性
Taobao.itempropvalues.get 获取标准类目属性值
Taobao.itemprops.get 获取标准商品类目属性
Taobao.itemcats.get 获取后台供卖家发布商品的标准商品类目
获取单笔交易信息
Taobao.trade.get 获取单笔交易的部分信息(性能高)
退款管理包
Taobao.refunds.apply.get 查询买家申请的退款列表
Taobao.refunds.receive.get 查询卖家收到的退款列表
Taobao.refund.get 获取单笔退款详情
Taobao.refund.messages.get 查询退款留言/凭证列表
Taobao.refund.message.add 创建退款留言/凭证
Taobao.refund.refuse 卖家拒绝退款
物流订单查询
Taobao.logistics.orders.detail.get 批量查询物流订单,返回详细信息
Taobao.logistics.orders.get 批量查询物流订单
Taobao.logistics.trace.search 物流流转信息查询
Taobao.wlb.order.jz.query 家装业务查询物流公司api
Taobao.wlb.order.jz.consign 家装发货接口
物流发货
Taobao.logistics.online.send 在线订单发货处理(支持货到付款)
Taobao.logistics.online.cancel 取消物流订单接口
Taobao.logistics.online.confirm 确认发货通知接口
Taobao.logistics.offline.send 自己联系物流(线下物流)发货
Taobao.logistics.dummy.send 无需物流(虚拟)发货处理
Taobao.logistics.order.create 创建物流订单
Taobao.logistics.consign.order.createandsend 创建订单并发货
Taobao.wlb.stores.baseinfo.get 商家按照仓的类型获取仓库接口
Taobao.logistics.consign.tc.confirm 通知交易确认发货接口
Cainiao.nbadd.appointdeliver.getconsigninfo 获取支持定时派送服务发货信息
订单编辑
Taobao.trade.memo.add 对一笔交易添加备注
Taobao.trade.memo.update 修改交易备注
Taobao.trade.ordersku.update 更新交易的销售属性
Taobao.trade.shippingaddress.update 更改交易的收货地址
Taobao.trade.receivetime.delay 延长交易收货时间
Taobao.trade.postage.update 修改交易邮费价格
订单信息查询
Taobao.trades.sold.get 查询卖家已卖出的交易数据(根据创建时间)
Taobao.trade.fullinfo.get 获取单笔交易的详细信息
Taobao.trades.sold.increment.get 查询卖家已卖出的增量交易数据(根据修改时间)
Taobao.trade.confirmfee.get 获取交易确认收货费用
Taobao.trade.amount.get 交易帐务查询
Taobao.trades.sold.incrementv.get 查询卖家已卖出的增量交易数据(根据入库时间)
退款退货
Taobao.rp.refunds.agree 同意退款
Taobao.rp.returngoods.agree 卖家同意退货
Taobao.rp.refund.review 审核退款单
Taobao.rp.returngoods.refill 卖家回填物流信息
Taobao.rp.returngoods.refuse 卖家拒绝退货
Taobao.refund.refusereason.get 获取拒绝原因列表
Tmall.dispute.receive.get 天猫逆向纠纷查询
评价信息更新
Taobao.traderate.add 新增单个评价
Taobao.traderate.list.add 针对父子订单新增批量评价
Taobao.traderate.explain.add 商城评价解释接口
评价信息查询
Taobao.traderates.get 搜索评价信息
Taobao.traderate.impr.imprwords.get 评价大家印象印象短语接口
Tmall.traderate.feeds.get 查询子订单对应的评价、追评以及语义标签
Tmall.traderate.itemtags.get 通过商品ID获取标签列表
电子面单
Taobao.wlb.waybill.i.get 获取物流服务商电子面单号v1.0
Taobao.wlb.waybill.i.search 查询面单服务订购及面单使用情况v1.0
Taobao.wlb.waybill.i.fullupdate 面单信息更新接口v1.0
Taobao.wlb.waybill.i.print 打印确认接口v1.0
Taobao.wlb.waybill.i.querydetail 查面单号状态v1.0
Taobao.wlb.waybill.i.cancel 商家取消获取的电子面单号v1.0
Taobao.wlb.waybill.i.product 商家查询物流商产品类型接口
Cainiao.waybill.ii.product 商家查询物流商产品类型接口
Cainiao.waybill.ii.cancel 商家取消获取的电子面单号
Cainiao.waybill.ii.get 电子面单云打印接口
Cainiao.waybill.ii.update 电子面单云打印更新接口
Cainiao.waybill.ii.query.by.tradecode 通过订单号查询电子面单通接口
Cainiao.waybill.ii.query.by.waybillcode 通过面单号查询面单信息
Cainiao.waybill.ii.search 查询面单服务订购及面单使用情况
卖家信息查询
Taobao.user.seller.get 查询卖家用户信息
商品接口列表:
产品管理包
Taobao.product.get 获取一个产品的信息
Taobao.products.search 搜索产品信息
Taobao.product.add 上传一个产品,不包括产品非主图和属性图片
Taobao.product.img.upload 上传单张产品非主图,如果需要传多张,可调多次
Taobao.product.propimg.upload 上传单张产品属性图片,如果需要传多张,可调多次
Taobao.product.update 修改一个产品,可以修改主图,不能修改子图片
Taobao.products.get 获取产品列表
商品类目属性
Taobao.itempropvalues.get 获取标准类目属性值
Taobao.itemprops.get 获取标准商品类目属性
Taobao.itemcats.get 获取后台供卖家发布商品的标准商品类目
店铺信息查询
Taobao.shopcats.list.get 获取前台展示的店铺类目
Taobao.sellercats.list.get 获取前台展示的店铺内卖家自定义商品类目
Taobao.shop.seller.get 卖家店铺基础信息查询
店铺信息更新
Taobao.sellercats.list.add 添加卖家自定义类目
Taobao.sellercats.list.update 更新卖家自定义类目
Taobao.shop.update 更新店铺基本信息
退款管理包
Taobao.refunds.apply.get 查询买家申请的退款列表
Taobao.refunds.receive.get 查询卖家收到的退款列表
Taobao.refund.get 获取单笔退款详情
Taobao.refund.messages.get 查询退款留言/凭证列表
Taobao.refund.message.add 创建退款留言/凭证
Taobao.refund.refuse 卖家拒绝退款
Schema商品发布
Tmall.item.schema.add 天猫根据规则发布商品
Tmall.item.add.schema.get 天猫发布商品规则获取
Tmall.product.add.schema.get 产品发布规则获取接口
Tmall.product.match.schema.get 获取匹配产品规则
Tmall.product.schema.match product匹配接口
Tmall.product.schema.add 使用Schema文件发布一个产品
Tmall.product.update.schema.get 产品更新规则获取接口
Tmall.product.schema.update 产品更新接口
Tmall.item.schema.update 天猫根据规则编辑商品
Tmall.item.update.schema.get 天猫编辑商品规则获取
Tmall.product.schema.get 产品信息获取schema获取
Tmall.item.increment.update.schema.get 天猫增量更新商品规则获取
Tmall.item.schema.increment.update 天猫根据规则增量更新商品
Tmall.item.add.simpleschema.get 天猫发布商品规则获取
Tmall.item.calculate.hscode.get 算法获取hscode
Tmall.item.hscode.detail.get 通过hscode获取计量单位
Tmall.item.hscode.audit.results.query 商品hscode信息审核状态查询接口
商品价格更新
Taobao.item.price.update 更新商品价格
Tmall.item.price.update 天猫商品/SKU价格更新接口
商品上下架
Taobao.item.update.delisting 商品下架
Taobao.item.update.listing 一口价商品上架
卖家商品查询
Taobao.items.onsale.get 获取当前会话用户出售中的商品列表
Taobao.item.sku.get 获取SKU
Taobao.item.skus.get 根据商品ID列表获取SKU信息
Taobao.itemcats.authorize.get 查询商家被授权品牌列表和类目列表
Taobao.items.inventory.get 得到当前会话用户库存中的商品列表
Taobao.items.custom.get 根据外部ID取商品
Taobao.skus.custom.get 根据外部ID取商品SKU
商品同步
Taobao.item.seller.get 获取单个商品详细信息
Taobao.items.seller.list.get 批量获取商品详细信息
商品编辑
Taobao.item.update 更新商品信息
Taobao.item.add 添加一个商品
Taobao.item.img.upload 添加商品图片
Taobao.item.img.delete 删除商品图片
Taobao.item.propimg.delete 删除属性图片
Taobao.item.propimg.upload 添加或修改属性图片
Taobao.item.sku.add 添加SKU
Taobao.item.sku.update 更新SKU信息
Taobao.item.delete 删除单条商品
Taobao.item.joint.img 商品关联子图
Taobao.item.joint.propimg 商品关联属性图
Taobao.item.sku.delete 删除SKU
Taobao.item.quantity.update 宝贝/SKU库存修改
Taobao.item.templates.get 获取用户宝贝详情页模板名称
Taobao.item.sku.price.update 更新商品SKU的价格
Taobao.skus.quantity.update SKU库存修改
Taobao.item.anchor.get 获取可用宝贝描述规范化模块
Tmall.item.desc.modules.get 商品描述模块信息获取
Taobao.item.barcode.update 更新商品条形码信息
Tmall.item.sizemapping.templates.list 获取天猫商品尺码表模板列表
Tmall.item.sizemapping.template.get 获取天猫商品尺码表模板
Tmall.item.sizemapping.template.delete 删除天猫商品尺码表模板
Tmall.item.sizemapping.template.update 更新天猫商品尺码表模板
Tmall.item.sizemapping.template.create 新增天猫商品尺码表模板
Tmall.item.outerid.update 天猫商品/SKU商家编码更新接口
Tmall.item.shiptime.update 更新商品发货时间
Tmall.item.simpleschema.add 天猫简化发布商品
Tmall.item.simpleschema.update 天猫简化编辑商品
Tmall.item.quantity.update 天猫商品/SKU库存更新接口
卖家信息查询
Taobao.user.seller.get 查询卖家用户信息
图片管理
Taobao.picture.category.get 获取图片分类信息
Taobao.picture.get 获取图片信息
Taobao.picture.delete 删除图片空间图片
Taobao.picture.upload 上传单张图片
Taobao.media.category.update 更新媒体文件分类
Taobao.picture.category.add 新增图片分类信息
Taobao.picture.category.update 更新图片分类
Taobao.picture.replace 替换图片
Taobao.picture.update 修改图片名字
Taobao.picture.userinfo.get 查询图片空间用户的信息
Taobao.picture.isreferenced.get 图片是否被引用
Taobao.picture.pictures.get 图片获取
Taobao.picture.pictures.count 图片总数查询