简介

这是淘宝 API 的一个简单灵活的 Python 客户端，由美折团队开发、维护

支持 Python 2.7+ 和 Python 3.6+

目前已在两个产品上使用 (美折, 美印)，日调用量过百万

有任何问题欢迎提交issue，或者联系邮箱：[email protected]

如何使用

# 引入该Client
from taobao import TaoBaoAPIClient

client = TaoBaoAPIClient('Your API Key','Your API Secret')
client.items_get(nicks='kamozi', fields='num_iid,title,price', page_no=1, page_size=2)

对于淘宝的某个 API，比如 taobao.AA.BB.CC.DD 调用的函数名为 AA_BB_CC_DD，即将前面的 taobao. 去掉并把后面的 '.' 全部换成 '_'

如果淘宝的某个 API 的参数中有 '.'，需要把 '.' 换成两个下划线 '__'，比如

client.item_update(location__state='杭州',num_iid='XXXXXX',session=xxxx)

对于 get 请求 client.get.AA_BB_CC_DD 中 get 可以省略，即 client.AA_BB_CC_DD

对于 post 请求，请使用 client.post.AA_BB_CC_DD

如果要上传文件，请使用 client.upload.AA_BB_CC_DD(image=open("Your File Path"))

例子

使用POST

client = APIClient('Your API Key','Your API Secret')
client.post.items_get(nicks='kamozi', fields='num_iid,title,price', page_no=1, page_size=2)

访问需授权内容

client = APIClient('Your API Key','Your API Secret')
client.post.item_update(num_iid=NUM_IID,title="这是一个新的商品信息服务",session='Your Session Key')

或者

client = APIClient('Your API Key','Your API Secret')
client.set_token('Your Session Key')
client.post.item_update(num_iid=NUM_IID,title="这是一个新的商品信息服务")

上传图片

client = APIClient('Your API Key','Your API Secret')
client.set_token('Your Session Key')
client.upload.item_img_upload(num_iid=NUM_IID, is_major='true', image=open("logo.png","rb"))

自定义客户端

def _debug_fetcher(request):
	opener = urllib2.build_opener(urllib2.HTTPHandler(debuglevel=1))
	return opener.open(request,timeout=5).read()

client = APIClient('Your API Key','Your API Secret')
client.set_fetcher(_debug_fetcher)
client.set_access_token(token)
client.upload.item_img_upload(num_iid=NUM_IID,is_major='true',image=open("logo.png","rb"))

访问沙箱

client = APIClient('Your API Key','Your API Secret',domain='container.api.tbsandbox.com')
client.items_get(nicks='test',fields='num_iid,title,price',page_no=1,page_size=2)