1.搜索当前会话用户作为卖家已卖出的交易数据(只能获取到三个月以内的交易信息)
a.返回的数据结果是以订单的创建时间倒序排列的。
b.返回的数据结果只包含了订单的部分数据,可通过taobao.trade.fullinfo.get获取订单详情。
注意:type字段的说明,如果该字段不传,接口默认只查4种类型订单,非默认查询的订单是不返回。遇到订单查不到的情况的,解决办法就是type加上订单类型就可正常返回了。
2.公共参数:
名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
method | String | 是 | API接口名称,例如:taobao.trades.sold.get |
app_key | String | 是 | TOP分配给应用的AppKey,例如:12345678 |
session | String | 否 | 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟 |
v | String | 是 | API协议版本,可选值:2.0 |
sign_method | String | 是 | 签名的摘要算法,可选值为:hmac,md5,hmac-sha256。 |
sign | String | 是 | API输入参数签名结果,签名算法介绍请点击这里 |
format | String | 否 | 响应格式。默认为xml格式,可选值:xml,json。 |
simplify | Boolean | 否 | 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false |
3.公共响应参数:
名称 | 类型 | 描述 |
|---|---|---|
request_id | String | 平台颁发的每次请求访问的唯一标识 |
error_response | String | 请求访问失败时返回的根节点 |
code | String | 请求失败返回的错误码 |
msg | String | 请求失败返回的错误信息 |
sub_code | String | 请求失败返回的子错误码 |
sub_msg | String | 请求失败返回的子错误信息 |
***_response | String | 请求成功返回的根节点,'***' 为API名称的下划线模式 |
4.请求示例(CURL、PHP 、PHPsdk 、Java 、C# 、Python…):
from topsdk.client import TopApiClient,TopException
if __name__ == '__main__':
# create Client
client = TopApiClient(appkey='<your-appkey>', app_sercet='<your-appsecret>', top_gateway_url='<top-gateway-url>',verify_ssl=False)
request_dict = {}
# 填充入参
# 如果为复杂类型,填数据结构json字符串
file_param_dict = {}
# 填充文件类型入参(如有)
try:
# 如果API不需要用户授权,user—session可以为""
response = client.execute_with_session("taobao.trades.sold.get",request_dict,file_param_dict,"<user-session>")
print(response)
except TopException as e:
print(e)备注:该接口代码可以用于获取店铺订单交易数据对接,包括订单详情数据,订单列表,直接对接淘宝开放平台API接口,利用淘宝应用市场内店铺授权拿到session id,进行接口对接。用于erp系统,店铺订单同步等业务,希望可以帮助有需要的朋友。