淘宝/天猫商品描述API接口(taobao.item_get_desc)返回值解读

在淘宝和天猫这两个国内领先的电商平台上,商品描述是卖家向消费者展示商品详情的重要工具。为了方便第三方开发者或商家能够获取商品描述信息,淘宝/天猫提供了相应的API接口。本文将对一个假设的API接口taobao.item_get_desc进行返回值解读,以帮助开发者更好地理解和使用该接口。

一、接口概述

taobao.item_get_desc接口主要用于获取淘宝/天猫平台上的商品描述信息。通过传入商品ID等参数,接口将返回包含商品描述的JSON格式数据。这些数据可以帮助开发者在自己的应用或系统中展示商品详情,提升用户体验。

二、返回值字段详解

  1. request_id:请求的唯一标识符。在调用接口时,系统会为每个请求生成一个唯一的ID,用于跟踪和调试。开发者可以在出现问题时提供此ID给技术支持人员,以便快速定位问题。

  2. item:包含商品信息的对象。

    • num_iid:商品ID,与传入参数一致。确保返回的数据与请求的商品相对应。
    • title:商品标题信息。开发者可以将此字段展示在商品列表或详情页中。
    • price:商品价格。可能包含货币单位等信息,开发者需要根据实际需要进行解析和展示。
    • desc:商品描述信息。通常为HTML格式,包含了商品的详细介绍、功能特点、使用方法等。开发者需要确保自己的应用或系统能够正确解析和渲染HTML内容,以便用户能够清晰地查看商品描述。
    • desc_images:商品描述图片列表。包含了商品描述中使用的图片的URL和位置信息。开发者可以将这些图片展示在商品详情页中,增强用户的购物体验。
    • detail_url:商品详情页链接。这是一个指向淘宝/天猫平台商品详情页的URL,用户点击后可以查看更多关于商品的信息。
    • other_fields:其他可能存在的字段信息。这些字段根据接口版本和平台策略可能有所不同,开发者需要查阅相关文档以了解具体含义和使用方法。
  3. error_response:错误信息。如果请求失败或出现问题,此字段将包含错误代码和描述信息。开发者需要根据错误信息进行相应的处理,如重试请求、提示用户等。

taobao.item_get_desc

公共参数

请求地址: https:/taobao/item_get_desc

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:num_iid=520813250866

参数说明:num_iid:淘宝商品ID

响应参数

Version: Date:

名称类型必须示例值描述

item

item[]0获得淘宝商品描述

响应示例

	"item": {
		"desc": "\n  <img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN01B8rO8q1YnDpqtaSHZ_!!2200639983103-1-scmitem6000.gif\" usemap=\"#IUSGU\" />\n  <map name=\"IUSGU\"><area shape=\"rect\" coords=\"6,10,786,541\" href=\"https://pages.tmall.com/wow/an/cs/act/wupr?wh_biz=tm&amp;wh_pid=3320144%2F17c73fe7b21&amp;disableNav=YES&amp;brandId=3320144&amp;chaoshi_brand_waitou=true\"></area><area shape=\"rect\" coords=\"9,561,169,731\" href=\"https://pages.tmall.com/wow/ark-pub/common/ee30c50a/tpl?wh_sid=a4a7a974fcf99970&amp;mcBrandCard=true\"></area><area shape=\"rect\" coords=\"211,561,371,721\" href=\"https://pages.tmall.com/wow/ark-pub/common/ee30c50a/tpl?wh_sid=b1f371c6cada937b&amp;mcBrandCard=true\"></area><area shape=\"rect\" coords=\"415,562,575,722\" href=\"https://pages.tmall.com/wow/ark-pub/common/ee30c50a/tpl?wh_sid=8fff1d96108c25a3&amp;mcBrandCard=true\"></area><area shape=\"rect\" coords=\"597,563,757,723\" href=\"https://pages.tmall.com/wow/ark-pub/common/ee30c50a/tpl?wh_sid=a4d5dbb8fee520eb&amp;mcBrandCard=true\"></area></map> \n  <img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN01MdspcQ1YnDpofKaYI_!!2200639983103-1-scmitem6000.gif\" usemap=\"#EMBND\" />\n  <map name=\"EMBND\"><area shape=\"rect\" coords=\"3,253,355,792\" href=\"https://chaoshi.detail.tmall.com/item.htm?id=627358747270&amp;skuId=4958439969412\"></area></map> \n  <p>&nbsp;</p> \n  <p>&nbsp;</p> \n  <p>&nbsp;</p> \n  <p>&nbsp;</p> \n  <p>&nbsp;</p> \n  <p>&nbsp;</p> \n  <p>&nbsp;<img src=\"http://img.alicdn.com/imgextra/i4/2200639983103/O1CN01K5mRzF1YnDhfbLqYO_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /></p> \n  <p>&nbsp;</p> \n  <p><map name=\"GPSIJ\"><area shape=\"rect\" coords=\"194,8,374,148\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=536597702698\"></area><area shape=\"rect\" coords=\"377,10,557,148\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=611943282371\"></area><area shape=\"rect\" coords=\"564,15,742,150\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=613199006000\"></area><area shape=\"rect\" coords=\"197,165,372,299\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=602723508607\"></area><area shape=\"rect\" coords=\"382,170,554,305\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=44107699067\"></area><area shape=\"rect\" coords=\"567,165,739,305\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=44187888589\"></area><area shape=\"rect\" coords=\"197,318,374,455\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=533938505960\"></area><area shape=\"rect\" coords=\"386,318,558,453\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=591828039537\"></area><area shape=\"rect\" coords=\"567,318,741,460\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=566408329269\"></area><area shape=\"rect\" coords=\"196,470,371,606\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=533971548851\"></area><area shape=\"rect\" coords=\"380,473,557,610\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=577183292025\"></area><area shape=\"rect\" coords=\"565,470,740,613\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=573075979265\"></area><area shape=\"rect\" coords=\"197,622,262,676\" href=\"\"></area><area shape=\"rect\" coords=\"199,624,374,758\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=554419816039\"></area><area shape=\"rect\" coords=\"381,620,556,762\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=592956242653\"></area><area shape=\"rect\" coords=\"564,623,739,764\" href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a1z34w.13877023.0.0.626531a5VcC2US&amp;id=604301910718\"></area></map> </p> \n  <p><a href=\"https://chaoshi.detail.tmall.com/item.htm?spm=a220o.7406545.0.0.32c7697bmJA9L1&amp;id=590048908797\" target=\"_blank\"></a></p> \n  <p><img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN01UzEW4I1YnDhVdkEFJ_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /></p> \n  <p>&nbsp;</p> \n  <p><img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN016eKqLt1YnDnXbDcWs_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2200639983103/O1CN01GDW3H61YnDnhPYxl7_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/3596645218/O1CN01seMU6n1oPt9fOvcj4_!!3596645218-0-scmitem6000.jpg\" /><img src=\"http://img.alicdn.com/imgextra/i2/2200639983103/O1CN0162Bmh21YnDnaPMaTM_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/3596645218/O1CN01f4fzGM1oPt9XJ7Hk2_!!3596645218-0-scmitem6000.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i4/3596645218/O1CN01rWjGD61oPt9fgZiT4_!!3596645218-0-scmitem6000.jpg\" /><img src=\"http://img.alicdn.com/imgextra/i2/2200639983103/O1CN01DfHuV61YnDjRoGnAQ_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN01QZgCx01YnDjXm4Y03_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/2142811280/O1CN01WxEC6x1LKHSoigkL0_!!2142811280-0-scmitem6000.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/2200639983103/O1CN01CzM2ro1YnDUFRy4lH_!!2200639983103-0-scmitem6000.jpg\" /><img src=\"http://img.alicdn.com/imgextra/i3/2200639983103/O1CN01hy4eW41YnDnoTFBOb_!!2200639983103-0-scmitem6000.jpg\" align=\"absmiddle\" /></p> &nbsp; \n  <p>&nbsp;</p> \n  <p>&nbsp;</p>\n  <script src=\"https://g.alicdn.com/i/popshop/0.0.23/p/seemore/load.js?c\"></script> \n ",
		"data_from": "app_vip"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:24 max:10000 all[39=24+0+15];expires:2030-12-31",
	"execution_time": "0.666",
	"server_time": "Beijing/2023-06-21 09:18:44",
	"client_ip": "115.153.49.96",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "0.86MB",
	"request_id": "gw-4.64924ff43c9b9",
	"last_id": "1821985889"

 异常示例

"error": "item-not-found",
		"reason": "商品没找到",
		"error_code": "2000",
		"success": 0,
		"cache": 0,
		"api_info": "today:0 max:10000",
		"execution_time": 0.081,
		"server_time": "Beijing/2020-06-10 23:44:00",
		"call_args": [],
		"api_type": "taobao",
		"request_id": "15ee0ffc041242"}

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误
  • 34
    点赞
  • 29
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 在 Python 中,使用 `multiprocessing.Pool()` 中的 `apply_async()` 方法可以异步提交进程池任务,并使用队列传递任务结果。 下面是一个使用队列传递返回值的示例代码: ```python import multiprocessing def worker(num, q): """子进程要执行的任务""" result = num * 2 q.put(result) # 将结果放入队列中 if __name__ == '__main__': # 创建队列和进程池 q = multiprocessing.Queue() pool = multiprocessing.Pool() # 提交任务到进程池中 for i in range(5): pool.apply_async(worker, args=(i, q)) # 关闭进程池 pool.close() # 等待所有进程完成任务 pool.join() # 从队列中获取结果 results = [] while not q.empty(): results.append(q.get()) # 输出结果 print(results) ``` 在这个示例中,首先创建了一个队列 `q` 和一个进程池 `pool`。然后,使用 `apply_async()` 方法向进程池提交任务,每个任务都会调用 `worker()` 函数,将计算结果放入队列中。在提交完所有任务后,关闭进程池并等待所有进程完成任务。最后,从队列中获取结果并输出。 需要注意的是,`apply_async()` 方法返回的是一个 `AsyncResult` 对象,可以使用 `get()` 方法获取任务的结果。但是,如果直接使用 `get()` 方法阻塞等待任务完成并获取结果,那么这种方式就是同步的了。因此,我们可以使用队列来异步获取结果,这样可以避免阻塞等待任务完成。 ### 回答2: 在使用`python pool.apply_async()`时,可以通过队列传递函数的返回值。 `pool.apply_async()`函数用于提交进程池中的可调用对象,并返回一个结果对象。通过该结果对象,可以获取可调用对象执行的结果。 为了实现使用队列传递返回值,我们可以先创建一个`multiprocessing.Manager()`对象,然后使用该对象的`Queue()`函数创建一个队列对象。 接下来,在调用`pool.apply_async()`时,将队列对象作为参数传递给可调用对象,使得可调用对象能够将返回值放入队列中。 然后,在主进程中,可以在需要的地方使用`queue.get()`方法从队列中获取返回值。该方法会阻塞主进程,直到队列中有可获取的返回值。 下面是一个示例代码: ```python import multiprocessing def my_func(queue): result = 10 # 假设计算得到的结果为10 queue.put(result) if __name__ == '__main__': manager = multiprocessing.Manager() queue = manager.Queue() pool = multiprocessing.Pool(processes=4) pool.apply_async(my_func, args=(queue,)) # 在需要的地方获取返回值 result = queue.get() print("结果:", result) ``` 在上述示例中,我们使用了`multiprocessing.Pool()`创建了一个进程池,并使用`pool.apply_async()`提交了可调用对象`my_func`。在`my_func`中,我们将计算得到的结果放入了队列`queue`中。 在主进程中,我们使用`queue.get()`阻塞主进程,并等待队列中的返回值。然后,将返回值打印出来。 这样就实现了通过队列传递返回值的功能。 ### 回答3: 在使用Python中的multiprocessing模块中的pool.apply_async方法时,我们可以通过队列来传递返回值。 pool.apply_async方法可以将函数异步地提交给进程池进行处理,并返回一个AsyncResult对象,该对象可以用于获取函数的返回值。 为了获取函数的返回值,我们可以创建一个队列,并将其作为参数传递给pool.apply_async方法。具体操作如下: 1. 导入multiprocessing模块中的Pool和Queue类: ``` from multiprocessing import Pool, Queue ``` 2. 创建一个队列对象: ``` result_queue = Queue() ``` 3. 定义一个函数,该函数将需要处理的任务作为参数,并使用队列将返回值传递出去: ``` def process_task(task): # 执行任务处理操作 # ... # 将返回值放入队列中 result_queue.put(result) ``` 4. 创建进程池对象: ``` pool = Pool() ``` 5. 提交任务给进程池进行处理,并获取AsyncResult对象: ``` async_result = pool.apply_async(process_task, (task,)) ``` 6. 从队列中获取函数的返回值: ``` result = result_queue.get() ``` 在上述代码中,我们首先创建了一个队列对象result_queue。然后,定义了一个处理任务的函数process_task,并将返回值放入队列中。接下来,创建了一个进程池对象pool,并使用apply_async方法提交任务给进程池。最后,从队列中获取函数的返回值result。 通过使用队列传递返回值,我们可以在多进程处理的情况下,方便地获取函数的结果并进行后续操作。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值