批量查询尺码
GET https://{handle}.myshopline.com/admin/openapi/v20250601/sizecharts.json
handle
:店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com
的店铺,其 handle
是 open001
。批量分页查询在尺码表应用中维护的产品尺码数据。
查询参数
- page_num integer分页获取尺码列表时传入的页码,未传时默认查询第 1 页数据。Example:
1
- page_size integer每页尺码表数量。默认数量:20取值范围:1-20Example:
20
请求头
- Content-Type required字段值固定为
application/json; charset=utf-8
- Authorization string required资源的访问令牌。请参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入Example:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
响应
- 200
- 401
- 429
更多状态码信息请参考 HTTP 状态码
响应头
traceId
traceId
响应体
dataobject
响应数据has_next boolean是否有下一页尺码数据。true
:表示有下一页数据false
:表示没有下一页数据
page_num integer当前所在页码位置。Example:1
page_size integer单页尺码表数量。Example:20
size_chartsobject[]
尺码表数据列表。applicable_attribute_list array尺码表适用的变体属性列表,尺码表将挂载在这些变体属性上进行展示。Example:size
applicable_product_type string将尺码表与产品进行匹配的方法类型。ALL
:适用所有商品SPECIFIC
:适用于制定商品COLLECTION
:适用于指定商品分类
Example:ALL
collection_list array当applicable_product_type
=COLLECTION
时,这个字段代表尺码表匹配的分类 ID 列表。Example:12260895952237462871473144
contentsobject[]
尺码内容数据列表。cross_table_contentobject
交叉表格类型的数据体。column_title string交叉表格中列的标题。Example:weight
column_unitobject
交叉表格中列的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:kg
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:lb
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 升 Example:WEIGHT
remark string交叉表格的备注。Example:1 lb = 0.45 kg,1 feet = 30.48 cm
row_title string交叉表格中行的标题。Example:high
row_unitobject
交叉表格中行的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:feet
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:cm
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 升 Example:LENGTH
size_dataobject[]
交叉表格的行数据,一个数组代表表格的一行数据,数组中每个元素代表一个单元格的数据。row_data array交叉表格行数据,数组中每个元素为一行数据中的一个单元格。Example:XS,64
table_contentobject
表格类型的数据体。country_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。country string国家名称。Example:US
data array表格中不同尺码在当前国家的名称数组。Example:78,89
cover_attribute boolean是否覆盖尺码规格文案,true
时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true
:表示覆盖●false
:表示不覆盖status boolean国家尺码功能开关。●true
:表示开启功能●false
:表示不开启功能Example:true
remark string表格备注。Example:1inch=2.54cm
size_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。Example:XS,64
unitobject
表格的尺码单位。convert_unit string转换单位,传入的单位需要归属于unit_type
中传入的单位类型,并且与default_unit
中传入的值不同。Example:in
default_unit string默认单位,传入的单位需要归属于unit_type
中传入的单位类型。Example:cm
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 升 Example:LENGTH
tabsobject[]
tab类型的数据体,1 个tab组件可包含最多 5 个tab分栏,每个分栏下可包含最多 10 个尺码数据体。tab下可包含tab,最多 2 级tab。tab_contentobject[]
tab分栏下的尺码数据。cross_table_contentobject
交叉表格类型的数据体。column_title string交叉表格中列的标题。Example:weight
column_unitobject
交叉表格中列的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:kg
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:lb
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 升 remark string交叉表格的备注。row_title string交叉表格中行的标题。Example:high
row_unitobject
交叉表格中行的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:feet
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:cm
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 升 Example:LENGTH
size_dataobject[]
交叉表格的行数据,一个数组代表表格的一行数据,数组中每个元素代表一个单元格的数据。row_data array交叉表格行数据,数组中每个元素为一行数据中的一个单元格。Example:XS,64
table_contentobject
表格类型的数据体。country_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。country string国家名称。data array表格中不同尺码在当前国家的名称数组。Example: ``cover_attribute boolean是否覆盖尺码规格文案,true
时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true
:表示覆盖●false
:表示不覆盖status boolean国家尺码功能开关。●true
:表示开启功能●false
:表示不开启功能remark string表格备注。size_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。Example: ``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 升 tabsobject[]
二级tab类型的数据体,最多5个二级tab的分栏,每个分栏下可包含最多10个尺码数据体。tab_contentobject[]
二级tab分栏下的数据内容。cross_table_contentobject
交叉表格类型的数据体。column_title string交叉表格中列的标题。column_unitobject
交叉表格中列的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:kg
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:lb
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 升 remark string交叉表格的备注。row_title string交叉表格中行的标题。row_unitobject
交叉表格中行的尺码单位。convert_unit string转换单位,需要归属于unit_type
中的单位类型,并且与default_unit
中的值不同。Example:feet
default_unit string默认单位,需要归属于unit_type
中传入的单位类型。Example:cm
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 升 Example:LENGTH
size_dataobject[]
交叉表格的行数据,一个数组代表表格的一行数据,数组中每个元素代表一个单元格的数据。row_data array交叉表格行数据,数组中每个元素为一行数据中的一个单元格。Example:XS,64
table_contentobject
表格类型的数据体。country_sizeobject
国家尺码数据,代表此表格内的尺码在不同国家下的名称。country_size_dataobject[]
国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。country string国家名称。data array表格中不同尺码在当前国家的名称数组。Example: ``cover_attribute boolean是否覆盖尺码规格文案,true
时 将使用国家尺码名称替代页面上的尺码属性值进行展示。●true
:表示覆盖●false
:表示不覆盖status boolean国家尺码功能开关。●true
:表示开启功能●false
:表示不开启功能remark string表格备注。size_dataobject[]
表格数据体,一个数组代表表格的一行数据,第一个数组为表头, 数组中的每个元素对应表格中的单元格数据。row_data array数组形式的表格行数据,数组中每个元素代表一个单元格。Example: ``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 升 text string文本类型内容。title string尺码表格的标题。type string二级Tab分栏中支持的内容类型枚举。枚举值 描述 SIZE_CHART 表格类型 CROSS_SIZE_CHART 交叉表格类型 IMAGE 图片类型 TEXT 文本类型 url string图片类型内容。tab_name string二级tab分栏的名称text string文本类型内容。title string尺码表格的标题。type stringTab分栏中支持的内容类型枚举。枚举值 描述 SIZE_CHART 表格类型 CROSS_SIZE_CHART 交叉表格类型 IMAGE 图片类型 TEXT 文本类型 TAB 二级tab类型 url string图片类型内容。tab_name stringTab分栏的名称text string文本类型内容。Example:My SizeChart
title string尺码表格的标题。Example:My SizeChart
type string尺码表中支持的内容类型枚举。枚举值 描述 SIZE_CHART 表格类型 CROSS_SIZE_CHART 交叉表格类型 IMAGE 图片类型 TEXT 文本类型 TAB tab类型 Example:SIZE_CHART
url string图片类型内容。Example:https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
create_time string按照东八时区记录的创建时间。 例如:Example:2024-08-23T16:04:42.527+08:00
language_scope string此尺码表与语言进行匹配所使用的方法类型。- ALL :全部语言(默认)。
- SPECIFIC:指定语言, 当
language_scope
=SPECIFIC
时,languages
不能为空,需通过languages
指定支持的语言。
languages array当language_scope
=SPECIFIC
时,从此字段获取尺码表匹配的语言代码列表,支持的语言枚举如下。- pt-pt: 葡萄牙语(葡萄牙)
- tr: 土耳其语
- zh-hans-cn: 简体中文
- vi: 越南语
- sv: 瑞典语
- zh-hant-tw: 繁体中文
- th: 泰语
- ar: 阿拉伯语
- pl: 波兰语
- ro: 罗马尼亚语
- sk: 斯洛伐克语
- ko: 韩语
- lv: 拉脱维亚语
- ms: 马来语
- pt: 葡萄牙语(巴西)
- it: 意大利语
- ja: 日语
- lt: 立陶宛语
- sl: 斯洛文尼亚语
- nb: 挪威语(博克马尔语)
- ru: 俄语
- nl: 荷兰语
- en: 英语
- id: 印度尼西亚语
- et: 爱沙尼亚语
- bg: 保加利亚语
- hi: 印地语
- cs: 捷克语
- es: 西班牙语
- fr: 法语
- fi: 芬兰语
- da: 丹麦语
- el: 希腊语
- de: 德语
- hr: 克罗地亚语
- hu: 匈牙利语
Example: ``product_list array当applicable_product_type
=SPECIFIC
时,这个字段代表尺码表匹配的商品 ID 列表,仅按添加顺序返回前100个添加的商品 ID。Example:16064649853088531841170520
size_chart_id string尺码表的唯一 ID。Example:13266288837293171311580520
status boolean尺码表的发布状态。枚举值 描述 true
表示发布尺码表 false
表示不发布尺码表 title string尺码表名称。Example:My SizeChart
update_time string按照东八时区记录的最近更新时间。Example:2024-08-23T16:04:42.527+08:00
total long当前页的尺码表数量。Example:1
API Explorer
调试台
示例代码
这篇文章对你有帮助吗?
Error loading component.