批量查询尺码
GET https://{handle}.myshopline.com/admin/openapi/v20260901/sizecharts.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handle 是 open001 。批量分页查询在尺码表应用中维护的产品尺码数据。
查询参数
- page_num integer分页获取尺码列表时传入的页码,未传时默认查询第 1 页数据。例子:
1 - page_size integer每页尺码表数量。默认数量:20取值范围:1-20例子:
20
请求头
- Content-Type string required字段值固定为
application/json; charset=utf-8。 - Authorization string required资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。例子:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
状态码
- 200
- 401
- 429
更多状态码信息,参考 HTTP 状态码。
响应头
traceId
请求的全局唯一标识符。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
dataobject
响应数据size_chartsobject[]
尺码表数据列表。language_scope string此尺码表与语言进行匹配所使用的方法类型。- ALL :全部语言(默认)。
- SPECIFIC:指定语言, 当
language_scope=SPECIFIC时,languages不能为空,需通过languages指定支持的语言。
status boolean尺码表的发布状态。枚举值 描述 true表示发布尺码表 false表示不发布尺码表 applicable_product_type string将尺码表与产品进行匹配的方法类型。ALL:适用所有商品SPECIFIC:适用于制定商品COLLECTION:适用于指定商品分类
例子:ALLcollection_list array当applicable_product_type=COLLECTION时,这个字段代表尺码表匹配的分类 ID 列表。例子:["12260895952237462871473144"]contentsobject[]
尺码内容数据列表。table_contentobject
表格类型的数据体。unitobject
表格的尺码单位。convert_unit string转换单位,传入的单位需要归属于unit_type中传入的单位类型,并且与default_unit中传入的值不同。例子:indefault_unit string默认单位,传入的单位需要归属于unit_type中传入的单位类型。例子:cmunit_type string表格支持的单位类型以及每一种类型中具体的度量单位。单位类型 单位类型描述 支持单位 支持单位描述 LENGTH 长度 feet 英尺 LENGTH 长度 m 米 LENGTH 长度 cm 厘米 LENGTH 长度 mm 毫米 LENGTH 长度 in 英寸 WEIGHT 重量(默认) lb 磅 WEIGHT 重量(默认) oz 盎司 WEIGHT 重量(默认) kg 千克 WEIGHT 重量(默认) g 克 WEIGHT 重量(默认) mg 毫克 BULK 体积 us_gal 加仑 (美) BULK 体积 uk_gal 加仑 (英) BULK 体积 oz_us 液体盎司 (美) BULK 体积 oz_uk 液体盎司(英) BULK 体积 ml 毫升 BULK 体积 l 升 例子:LENGTHcountry_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。country string国家名称。例子:USdata array表格中不同尺码在当前国家的名称数组。例子:["78,89"]cover_attribute boolean是否覆盖尺码规格文案,true时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true:表示覆盖●false:表示不覆盖status boolean国家尺码功能开关。●true:表示开启功能●false:表示不开启功能例子:trueremark string表格备注。例子:1inch=2.54cmsize_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。例子:["XS,64"]tabsobject[]
tab类型的数据体,1 个tab组件可包含最多 5 个tab分栏,每个分栏下可包含最多 10 个尺码数据体。tab下可包含tab,最多 2 级tab。tab_contentobject[]
tab分栏下的尺码数据。table_contentobject
表格类型的数据体。size_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。例子:[""]unitobject
表格的尺码单位。unit_type string表格支持的单位类型以及每一种类型中具体的度量单位。单位类型 单位类型描述 支持单位 支持单位描述 LENGTH 长度 feet 英尺 LENGTH 长度 m 米 LENGTH 长度 cm 厘米 LENGTH 长度 mm 毫米 LENGTH 长度 in 英寸 WEIGHT 重量(默认) lb 磅 WEIGHT 重量(默认) oz 盎司 WEIGHT 重量(默认) kg 千克 WEIGHT 重量(默认) g 克 WEIGHT 重量(默认) mg 毫克 BULK 体积 us_gal 加仑 (美) BULK 体积 uk_gal 加仑 (英) BULK 体积 oz_us 液体盎司 (美) BULK 体积 oz_uk 液体盎司(英) BULK 体积 ml 毫升 BULK 体积 l 升 convert_unit string转 换单位,传入的单位需要归属于unit_type中传入的单位类型,并且与default_unit中传入的值不同。default_unit string默认单位,传入的单位需要归属于unit_type中传入的单位类型。country_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。status boolean国家尺码功能开关。●true:表示开启功能●false:表示不开启功能country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。data array表格中不同尺码在当前国家的名称数组。例子:[""]country string国家名称。cover_attribute boolean是否覆盖尺码规格文案,true时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true:表示覆盖●false:表示不覆盖remark string表格备注。tabsobject[]
二级tab类型的数据体,最多5个二级tab的分栏,每个分栏下可包含最多10个尺码数据体。tab_contentobject[]
二级tab分栏下的数据内容。table_contentobject
表格类型的数据体。remark string表格备注。size_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。例子:[""]unitobject
表格的尺码单位。convert_unit string转换单位,传入的单位需要归属于unit_type中传入的单位类型,并且与default_unit中传入的值不同。default_unit string默认单位,传入的单位需要归属于unit_type中传入的单位类型。unit_type string表格支持的单位类型以及每一种类型中具体的度量单位。单位类型 单位类型描述 支持单位 支持单位描述 LENGTH 长度 feet 英尺 LENGTH 长度 m 米 LENGTH 长度 cm 厘米 LENGTH 长度 mm 毫米 LENGTH 长度 in 英寸 WEIGHT 重量(默认) lb 磅 WEIGHT 重量(默认) oz 盎司 WEIGHT 重量(默认) kg 千克 WEIGHT 重量(默认) g 克 WEIGHT 重量(默认) mg 毫克 BULK 体积 us_gal 加仑 (美) BULK 体积 uk_gal 加仑 (英) BULK 体积 oz_us 液体盎司 (美) BULK 体积 oz_uk 液体盎司(英) BULK 体积 ml 毫升 BULK 体积 l 升 country_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。country string国家名称。data array表格中不同尺码在当前国家的名称数组。例子:[""]cover_attribute boolean是否覆盖尺码规格文案,true时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true:表示覆盖●false:表示不覆盖status boolean国家尺码功能开关。●true:表示开启功能●false:表示不开启功能text string文本类型内容。title string尺码表格的标题。type string