一、taobao.trade.get-获取单笔交易的部分信息(性能高) ,订单交易API接口,淘宝r2API接口,淘宝oAuth2.0API接口 代码分享
1.请求参数:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称,例如:taobao.trade.get |
app_key | String | 是 | TOP分配给应用的AppKey,例如:12345678 (点击获取key和secret) |
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 |
2.响应参数:
名称 | 类型 | 描述 |
---|---|---|
request_id | String | 平台颁发的每次请求访问的唯一标识 |
error_response | String | 请求访问失败时返回的根节点 |
code | String | 请求失败返回的错误码 |
msg | String | 请求失败返回的错误信息 |
sub_code | String | 请求失败返回的子错误码 |
sub_msg | String | 请求失败返回的子错误信息 |
***_response | String | 请求成功返回的根节点,'***' 为API名称的下划线模式 |
3.请求示例(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.trade.get",request_dict,file_param_dict,"<user-session>")
print(response)
except TopException as e:
print(e)
备注:该接口代码可以用于获取店铺订单交易数据对接,单笔订单交易信息接口,包括订单详情数据,订单列表,直接对接淘宝开放平台API接口,利用淘宝应用市场内店铺授权拿到session id,进行接口对接。用于店群业务,erp系统,店铺订单同步等业务,希望可以帮助有需要的朋友。