蔬东坡开放平台 V2 版本更新通知

版本信息

版本号：17.4.0

整理时间：2026-09-24

本版本变更概览

17.4.0 版本新增商品溯源查询接口，为商品列表和 SKU 列表增加商品标签；调整内部鉴权账号获取令牌时对 OpenAPI 开通配置的校验行为，并明确内部调用接口的 QPS 限额。

接口变更明细

1. `GET /openApiV2/commodity/getCommodityTraceList`

接口名称：获取商品溯源信息

变更类型：新增接口

接口说明：根据商品溯源码查询商品、采购、生产、检测、分拣、配送、订单及企业等溯源信息。

请求参数：

origin_code：商品溯源码，必填，类型为 string。

返回说明：

view_info：访问查看信息，包含访问次数、首次访问时间、本次查询时间和溯源码等。

commodity_info：商品信息，包含商品 ID、名称、编码、单位、规格、图片、分类、品牌、产地、保质期、批次及单位换算等。

purchase_info：采购信息列表，包含采购单、供应商、采购时间、收货时间、配送日期、采购批次、采购数量、采购单位、采购价格、生产信息及供应商资质等。

production_info：生产信息列表，包含生产日期、批次号、生产厂商、厂商资质及质检报告附件等。

trace_info：溯源信息列表，包含检测日期、检测机构、检测员、报告图片或 PDF、动态溯源值及自定义字段等。

purchase_and_sort_info：采购、分拣及配送信息，包含分拣时间、分拣员、配送司机、司机电话、配送时间、车牌号及司机资质等。

order_info：订单商品信息，包含订单、订单商品、客户、门店、司机、溯源码、数量、单位、生产日期及配送时间等。

enterprise_info：企业信息列表，包含企业名称、简介、地址、联系方式、Logo、资质及企业自定义展示信息。

wap_origin_url：溯源详情页地址，类型为 string。

权限说明：新增至 OpenAPI V2 商品接口权限列表，对外可见。

限频说明：外部调用 20 QPS，内部调用 20 QPS。

2. `GET /openApiV2/commodity/pageList`

接口名称：获取商品列表

变更类型：新增返回字段

新增返回字段：

commodity_tag：商品标签，类型为 string；商品无标签时返回空字符串。

3. `GET /openApiV2/commodity/pageSkuList`

接口名称：获取商品 SKU 列表

变更类型：新增返回字段

新增返回字段：

commodity_tag：商品标签，类型为 string；商品无标签时返回空字符串。

来源页面

商品溯源查询接口定义（仓库文件）

17.4.0版本更新

蔬东坡开放平台 V2 版本更新通知#

版本信息#

本版本变更概览#

接口变更明细#

1. GET /openApiV2/commodity/getCommodityTraceList#

2. GET /openApiV2/commodity/pageList#

3. GET /openApiV2/commodity/pageSkuList#

来源页面#