淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
param0	String	必须	207380346696994386	默认值：207380346696994386	hsf的应用id
param1	String	必须	intelligent-chatbot	默认值：intelligent-chatbot	服务名称
param2	String	必须	officialItemHttpService-queryItemOCRByHSF	默认值：officialItemHttpService-queryItemOCRByHSF	函数名称
param3	CustomerServiceRequest	必须			入参
└ item_id String 必须 833953187879 商品id
param4	String	必须	officialItemHttpService-queryItemOCRByHSF__stable	默认值：officialItemHttpService-queryItemOCRByHSF__stable	版本号

名称	类型	示例值	描述
data	Data		返回数据对象
└ item_id String 955195141638 商品id └ ocr_property String "- 品牌：海尔\n- 产品类型：立式空调（柜机）\n- 冷暖功能：冷暖两用\n- 制冷模式下15秒速冷，出风口温度可达22℃\n- 制热模式下30秒速热，出风30秒后出风口温度可达42℃\n- 能效等级：超一级能效\n- 核心技术：全新跃频科技、复式增压机械导风、内外机自清洁、负离子健康空气技术\n- 导风设计：复式双层导风摆叶，风速提升20%，冷风极限上扬60°，实现“一步不吹人”\n- 风速控制：“冷风‘一步不吹人’”指开启制冷防直吹模式后，空调正前方1-4米远1.8米高的位置风速小于0.3米/秒\n- 自清洁功能：\n - 内机自清洁：除尘、出风更清新，建议每两周一次\n - 高温自清洁：高温除菌，呼吸更健康，建议每月一次\n - 内外机自清洁：省电高效节能，建议换季使用\n - 除菌率高达99.9%\n - 外机散热片结霜全覆盖，冲洗污垢更强力\n- 换热器材质：\n - 多齿数内螺纹铜管：换热效率提升21.1%，换热面积增加80.5%\n - 纯铜冷凝器（室外机）：高效换热硬核节能\n - 纯铜蒸发器（室内机）：增大换热面积，省电效果更优\n- 工艺与质量：\n - 全自动焊接工艺：纯铜管换热器采用全自动焊接，焊点精准稳定，质量更安心\n - 整机出厂前AI视觉质检：AI感知整机生产每一环，保障每台空调都是好品质\n- 压缩机：\n - 采用三菱顶尖品牌压缩机\n - 升级17.2cc大排量，澎湃动力\n - 高效换热，极速冷暖\n- 安装服务：\n - 专业服务精工安装\n - 最后一公里服务网络\n - 三分产品，七分安装\n - 自建专业服务团队全程保障\n- 噪音水平：22分贝低噪音\n- 抑噪静音技术：出风更安静，呵护家人一夜好眠\n- 负离子功能：\n - 千万级负离子健康森呼吸\n - 亿级负离子释放\n - 负离子被称为“空气维生素”，具有保健人体、提高免疫力、改善睡眠、抗氧化、除菌降尘、清新空气等多种作用\n- 空气净化能力：\n - 一机顶六机：多维还原自然好空气\n - 洗空气空调=除湿机+空气消毒机+空气循环扇+空调+空气净化器+空气清新机\n- 健康认证：\n - 获得中国家用电器研究院—嘉电测评五星级健康好空气证书，编号：UET-Kt-24 005A\n - 获得发明专利证书，专利号：ZL201710003009.1、ZL201710449089.3、ZL201810152143.2\n - 获得11篇国家级证书，包括离子除菌、空调器控制逻辑技术等\n- 极端环境适应性：\n - 硬刚65℃高温，极端环境运行稳如磐石\n - 外机不怕高温闷热，室内始终凉爽宜人\n - 凉芯桥65℃高温制冷不停机，报告编号：WTS2025-11326\n- 负离子浓度参考数据：\n - 神农架：30000个/cm³\n - 九寨沟：18400个/cm³\n - 广西巴马：50000个/cm³\n - 千岛湖：62000个/cm³\n- 促销信息：\n - 3匹洗空气科技款补贴到手价：7299元\n - 3匹洗空气旗舰款补贴到手价：7999元\n - 3匹洗空气舒享款补贴到手价：6299元\n - 政府补贴立省15%\n - 以旧换新至高补贴650元\n - 6年包修\n - 365天只换不修\n - 购机秀图送海尔兄弟空调被\n - 送货安装一次完成\n - 支持预约配送30天\n - 保价30天\n - 乡村镇可达\n- 图片说明标注：*该图为KFR-72LW/E3-1型号说明" 图文信息

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemOcrGetRequest req = new TmallItemOcrGetRequest();
req.setParam0("207380346696994386");
req.setParam1("intelligent-chatbot");
req.setParam2("officialItemHttpService-queryItemOCRByHSF");
TmallItemOcrGetRequest.CustomerServiceRequest obj1 = new TmallItemOcrGetRequest.CustomerServiceRequest();
obj1.setItemId("833953187879");
req.setParam3(obj1);
req.setParam4("officialItemHttpService-queryItemOCRByHSF__stable");
TmallItemOcrGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallItemOcrGetRequest req = new TmallItemOcrGetRequest();
req.Param0 = "207380346696994386";
req.Param1 = "intelligent-chatbot";
req.Param2 = "officialItemHttpService-queryItemOCRByHSF";
TmallItemOcrGetRequest.CustomerServiceRequestDomain obj1 = new TmallItemOcrGetRequest.CustomerServiceRequestDomain();
obj1.ItemId = "833953187879";
req.Param3_ = obj1;
req.Param4 = "officialItemHttpService-queryItemOCRByHSF__stable";
TmallItemOcrGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallItemOcrGetRequest;
$req->setParam0("207380346696994386");
$req->setParam1("intelligent-chatbot");
$req->setParam2("officialItemHttpService-queryItemOCRByHSF");
$param3 = new CustomerServiceRequest;
$param3->item_id="833953187879";
$req->setParam3(json_encode($param3));
$req->setParam4("officialItemHttpService-queryItemOCRByHSF__stable");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.item.ocr.get' \
-d 'partner_id=apidoc' \
-d 'sign=2FF156E84C974FB1C281FFE5FF00C63C' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-04-04+12%3A01%3A50' \
-d 'v=2.0' \
-d 'param0=207380346696994386' \
-d 'param1=intelligent-chatbot' \
-d 'param2=officialItemHttpService-queryItemOCRByHSF' \
-d 'param3=null' \
-d 'param4=officialItemHttpService-queryItemOCRByHSF__stable'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TmallItemOcrGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.param0="207380346696994386"
req.param1="intelligent-chatbot"
req.param2="officialItemHttpService-queryItemOCRByHSF"
req.param3="数据结构示例JSON格式"
req.param4="officialItemHttpService-queryItemOCRByHSF__stable"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"tmall.item.ocr.get");
add_param(pRequest,"param0","207380346696994386");
add_param(pRequest,"param1","intelligent-chatbot");
add_param(pRequest,"param2","officialItemHttpService-queryItemOCRByHSF");
add_param(pRequest,"param3","数据结构JSON示例");
add_param(pRequest,"param4","officialItemHttpService-queryItemOCRByHSF__stable");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.item.ocr.get', {
	'param0':'207380346696994386',
	'param1':'intelligent-chatbot',
	'param2':'officialItemHttpService-queryItemOCRByHSF',
	'param3':'数据结构JSON示例',
	'param4':'officialItemHttpService-queryItemOCRByHSF__stable'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_item_ocr_get_response>
    <data>
        <item_id>955195141638</item_id>
        <ocr_property>&quot;- 品牌：海尔\n- 产品类型：立式空调（柜机）\n- 冷暖功能：冷暖两用\n- 制冷模式下15秒速冷，出风口温度可达22℃\n- 制热模式下30秒速热，出风30秒后出风口温度可达42℃\n- 能效等级：超一级能效\n- 核心技术：全新跃频科技、复式增压机械导风、内外机自清洁、负离子健康空气技术\n- 导风设计：复式双层导风摆叶，风速提升20%，冷风极限上扬60°，实现“一步不吹人”\n- 风速控制：“冷风‘一步不吹人’”指开启制冷防直吹模式后，空调正前方1-4米远1.8米高的位置风速小于0.3米/秒\n- 自清洁功能：\n  - 内机自清洁：除尘、出风更清新，建议每两周一次\n  - 高温自清洁：高温除菌，呼吸更健康，建议每月一次\n  - 内外机自清洁：省电高效节能，建议换季使用\n  - 除菌率高达99.9%\n  - 外机散热片结霜全覆盖，冲洗污垢更强力\n- 换热器材质：\n  - 多齿数内螺纹铜管：换热效率提升21.1%，换热面积增加80.5%\n  - 纯铜冷凝器（室外机）：高效换热硬核节能\n  - 纯铜蒸发器（室内机）：增大换热面积，省电效果更优\n- 工艺与质量：\n  - 全自动焊接工艺：纯铜管换热器采用全自动焊接，焊点精准稳定，质量更安心\n  - 整机出厂前AI视觉质检：AI感知整机生产每一环，保障每台空调都是好品质\n- 压缩机：\n  - 采用三菱顶尖品牌压缩机\n  - 升级17.2cc大排量，澎湃动力\n  - 高效换热，极速冷暖\n- 安装服务：\n  - 专业服务精工安装\n  - 最后一公里服务网络\n  - 三分产品，七分安装\n  - 自建专业服务团队全程保障\n- 噪音水平：22分贝低噪音\n- 抑噪静音技术：出风更安静，呵护家人一夜好眠\n- 负离子功能：\n  - 千万级负离子健康森呼吸\n  - 亿级负离子释放\n  - 负离子被称为“空气维生素”，具有保健人体、提高免疫力、改善睡眠、抗氧化、除菌降尘、清新空气等多种作用\n- 空气净化能力：\n  - 一机顶六机：多维还原自然好空气\n  - 洗空气空调=除湿机+空气消毒机+空气循环扇+空调+空气净化器+空气清新机\n- 健康认证：\n  - 获得中国家用电器研究院—嘉电测评五星级健康好空气证书，编号：UET-Kt-24 005A\n  - 获得发明专利证书，专利号：ZL201710003009.1、ZL201710449089.3、ZL201810152143.2\n  - 获得11篇国家级证书，包括离子除菌、空调器控制逻辑技术等\n- 极端环境适应性：\n  - 硬刚65℃高温，极端环境运行稳如磐石\n  - 外机不怕高温闷热，室内始终凉爽宜人\n  - 凉芯桥65℃高温制冷不停机，报告编号：WTS2025-11326\n- 负离子浓度参考数据：\n  - 神农架：30000个/cm³\n  - 九寨沟：18400个/cm³\n  - 广西巴马：50000个/cm³\n  - 千岛湖：62000个/cm³\n- 促销信息：\n  - 3匹洗空气科技款补贴到手价：7299元\n  - 3匹洗空气旗舰款补贴到手价：7999元\n  - 3匹洗空气舒享款补贴到手价：6299元\n  - 政府补贴立省15%\n  - 以旧换新至高补贴650元\n  - 6年包修\n  - 365天只换不修\n  - 购机秀图送海尔兄弟空调被\n  - 送货安装一次完成\n  - 支持预约配送30天\n  - 保价30天\n  - 乡村镇可达\n- 图片说明标注：*该图为KFR-72LW/E3-1型号说明&quot;</ocr_property>
    </data>
</tmall_item_ocr_get_response>

{
    "tmall_item_ocr_get_response":{
        "data":{
            "item_id":"955195141638",
            "ocr_property":" \"- 品牌：海尔\\n- 产品类型：立式空调（柜机）\\n- 冷暖功能：冷暖两用\\n- 制冷模式下15秒速冷，出风口温度可达22℃\\n- 制热模式下30秒速热，出风30秒后出风口温度可达42℃\\n- 能效等级：超一级能效\\n- 核心技术：全新跃频科技、复式增压机械导风、内外机自清洁、负离子健康空气技术\\n- 导风设计：复式双层导风摆叶，风速提升20%，冷风极限上扬60°，实现“一步不吹人”\\n- 风速控制：“冷风‘一步不吹人’”指开启制冷防直吹模式后，空调正前方1-4米远1.8米高的位置风速小于0.3米\/秒\\n- 自清洁功能：\\n  - 内机自清洁：除尘、出风更清新，建议每两周一次\\n  - 高温自清洁：高温除菌，呼吸更健康，建议每月一次\\n  - 内外机自清洁：省电高效节能，建议换季使用\\n  - 除菌率高达99.9%\\n  - 外机散热片结霜全覆盖，冲洗污垢更强力\\n- 换热器材质：\\n  - 多齿数内螺纹铜管：换热效率提升21.1%，换热面积增加80.5%\\n  - 纯铜冷凝器（室外机）：高效换热硬核节能\\n  - 纯铜蒸发器（室内机）：增大换热面积，省电效果更优\\n- 工艺与质量：\\n  - 全自动焊接工艺：纯铜管换热器采用全自动焊接，焊点精准稳定，质量更安心\\n  - 整机出厂前AI视觉质检：AI感知整机生产每一环，保障每台空调都是好品质\\n- 压缩机：\\n  - 采用三菱顶尖品牌压缩机\\n  - 升级17.2cc大排量，澎湃动力\\n  - 高效换热，极速冷暖\\n- 安装服务：\\n  - 专业服务精工安装\\n  - 最后一公里服务网络\\n  - 三分产品，七分安装\\n  - 自建专业服务团队全程保障\\n- 噪音水平：22分贝低噪音\\n- 抑噪静音技术：出风更安静，呵护家人一夜好眠\\n- 负离子功能：\\n  - 千万级负离子健康森呼吸\\n  - 亿级负离子释放\\n  - 负离子被称为“空气维生素”，具有保健人体、提高免疫力、改善睡眠、抗氧化、除菌降尘、清新空气等多种作用\\n- 空气净化能力：\\n  - 一机顶六机：多维还原自然好空气\\n  - 洗空气空调=除湿机+空气消毒机+空气循环扇+空调+空气净化器+空气清新机\\n- 健康认证：\\n  - 获得中国家用电器研究院—嘉电测评五星级健康好空气证书，编号：UET-Kt-24 005A\\n  - 获得发明专利证书，专利号：ZL201710003009.1、ZL201710449089.3、ZL201810152143.2\\n  - 获得11篇国家级证书，包括离子除菌、空调器控制逻辑技术等\\n- 极端环境适应性：\\n  - 硬刚65℃高温，极端环境运行稳如磐石\\n  - 外机不怕高温闷热，室内始终凉爽宜人\\n  - 凉芯桥65℃高温制冷不停机，报告编号：WTS2025-11326\\n- 负离子浓度参考数据：\\n  - 神农架：30000个\/cm³\\n  - 九寨沟：18400个\/cm³\\n  - 广西巴马：50000个\/cm³\\n  - 千岛湖：62000个\/cm³\\n- 促销信息：\\n  - 3匹洗空气科技款补贴到手价：7299元\\n  - 3匹洗空气旗舰款补贴到手价：7999元\\n  - 3匹洗空气舒享款补贴到手价：6299元\\n  - 政府补贴立省15%\\n  - 以旧换新至高补贴650元\\n  - 6年包修\\n  - 365天只换不修\\n  - 购机秀图送海尔兄弟空调被\\n  - 送货安装一次完成\\n  - 支持预约配送30天\\n  - 保价30天\\n  - 乡村镇可达\\n- 图片说明标注：*该图为KFR-72LW\/E3-1型号说明\""
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

天猫优品

tmall.item.ocr.get (获取天猫优品商品图文信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ