文档中心 > API类目 > 淘宝商品API

taobao.item.sizemapping.ocr (基于尺码图片识别商品尺码表信息)

基于尺码图片识别商品尺码表信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cat_id Number 必须 50000852 商品叶子类目 ID,必须大于 0。
selected_sizes SizeChartOcrSelectedSize 必须 商家当前已选尺码列表,至少一项。标准尺码传正数 ID;自定义尺码有负数 ID 时传该 ID,拿不到或新发时传 -1。
  • └ v_id
  • Number
  • 必须
  • 28314
  • 尺码属性值 ID,不能为 0。标准尺码传正数;自定义尺码传已有负数 ID,拿不到或新发时传 -1。
  • └ v_text
  • String
  • 必须
  • S
  • 尺码展示文本,不能为空、不能带首尾空格,同一请求内忽略大小写后不能重复。
size_group String 必须 27013-women_bottoms 当前选择的尺码分组,必须来自该类目的发品数据。
url_list String 必须 ["https://img.alicdn.com/example/detail-1.jpg","https://img.alicdn.com/example/size-chart.jpg"] 商品详情描述中的全部图片地址,最多 20 张。仅支持公网 HTTP/HTTPS 地址,服务端负责筛选尺码图。
user_info_request UserInfoRequest 可选 TOP 调用身份对象,字段由业务参数和系统参数映射,用于身份识别、限流和问题排查。
  • └ request_id
  • String
  • 可选
  • ocr_20260922_0001
  • 调用方请求标识,用于链路排查;建议每次调用使用唯一值。

响应参数

名称 类型 示例值 描述
additional_data String <itemSchema>...</itemSchema> 尺码图片识别结果,完整 itemSchema XML;包含尺码销售属性、结构化尺码表和识别质量。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemSizemappingOcrRequest req = new ItemSizemappingOcrRequest();
req.setCatId(50000852L);
ItemSizemappingOcrRequest.SizeChartOcrSelectedSize obj1 = new ItemSizemappingOcrRequest.SizeChartOcrSelectedSize();
obj1.setVId(28314L);
obj1.setVText("S");
req.setSelectedSizes(obj1);
req.setSizeGroup("27013-women_bottoms");
req.setUrlList("[\"https://img.alicdn.com/example/detail-1.jpg\",\"https://img.alicdn.com/example/size-chart.jpg\"]");
ItemSizemappingOcrRequest.UserInfoRequest obj2 = new ItemSizemappingOcrRequest.UserInfoRequest();
obj2.setRequestId("ocr_20260922_0001");
req.setUserInfoRequest(obj2);
ItemSizemappingOcrResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<item_sizemapping_ocr_response>
    <additional_data>&lt;itemSchema&gt;...&lt;/itemSchema&gt;</additional_data>
</item_sizemapping_ocr_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部