需要 write_product_sizechart 权限点。
更多权限点使用信息,请参考:
PUT https://{handle}.myshopline.com/admin/openapi/v20250601/sizechart.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handleopen001
更新尺码表,商品将优先使用最新更新的尺码数据进行展示。
请求头
  • Content-Type required
    字段值固定为application/json; charset=utf-8
  • Authorization string required
    资源的访问令牌。请参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • reqobject
    请求参数。
  • applicable_attribute_list array
    是一个尺码表适用商品属性的列表,每个属性可以用来描述商品的特征,如 size 等。
    单个变体属性名称长度限制:255
    最大个数限制:50
    Example: size
  • applicable_product_type string
    将尺码表与商品进行匹配的方法类型。
    • ALL:适用所有商品
    • SPECIFIC:适用于指定商品
    • COLLECTION:适用于指定商品分类
    默认值:ALL
    Example: ALL
  • collection_list array
    applicable_product_type 传入 COLLECTION 时,使用此字段传入尺码表匹配的商品分类 ID 列表。
    最大个数限制:50
    Example: 12260895952237462871473144
  • contentsobject[]
    尺码数据列表,按顺序从第一个尺码数据开始取,取到最大数量后将会截断剩余数据。
    最大数量限制:10
  • cross_table_contentobject
    交叉表格类型的数据体,常用于显示不同身体参数适合的具体尺码。例如身高170cm,体重70kg适用L。
  • column_title string
    交叉表格中列的标题,用于说明列的数据代表的尺码信息。例如 weight 表示列的数据为体重数据。默认为 weight
    最大长度限制:20
    Example: weight
  • column_unitobject
    交叉表格中列的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 kg
    Example: kg
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 lb
    Example: lb
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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
    交叉表格的备注。
    最大长度限制:255
    Example: 1 lb = 0.45 kg,1 feet = 30.48 cm
  • row_title string
    交叉表格中行的标题,用于说明行的数据代表的尺码信息。例如 height 表示行的数据为身高数据。
    默认为 height
    最大长度限制:20
    Example: height
  • row_unitobject
    交叉表格中行的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 feet
    Example: feet
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
    Example: cm
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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[] required
    交叉表格数据体,第一个元素为表头,数组中的每个元素对应表格中的一行数据。
    最大个数限制:50
  • row_data array required
    交叉表格行数据,数组中每个元素为一行数据中的一个单元格。
    每行最大单元格数:50
    每个单元格最大长度限制:19
    Example: XS,64
  • table_contentobject
    表格类型的数据体,常用于以表格形式显示尺码数据。例如 S 的肩宽是60,腰围是55。
  • country_sizeobject
    国家尺码数据,代表此表格内的尺码在不同国家下的名称。
  • country_size_dataobject[] required
    国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。
  • country string required
    国家名称。
    最大长度限制:19
    Example: United States
  • data array required
    表格中不同尺码在当前国家的名称数组。
    最大个数限制:21
    数组中每个元素最大长度限制:19
    Example: 78,89
  • cover_attribute boolean
    是否覆盖尺码规格文案,传入 true 时将使用国家尺码名称替代页面上的尺码属性值进行展示。
    true:表示覆盖
    false:表示不覆盖
    默认取值为 false
  • status boolean
    是否开启国家尺码功能开关。
    true:表示开启功能
    false:表示不开启功能
    默认取值为false
    Example: true
  • remark string
    表格备注。
    最大长度限制:255
    Example: 1inch=2.54cm
  • size_dataobject[] required
    表格数据体,一个数组代表表格的一行数据,第一个数组为表头,数组中的每个元素对应表格中的单元格数据。
    最大行数限制:50
  • row_data array required
    数组形式的表格行数据,数组中每个元素代表一个单元格。
    每个数组最大元素数量:50
    每个元素最大长度限制为:19
    Example: XS,64
  • unitobject
    表格的尺码数据使用的单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 in
    Example: in
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
    Example: cm
  • unit_type string
    表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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 类型的数据体,可添加多个 tab 分栏并在分栏内添加各类型的尺码数据内容。
    最大分栏数量限制:5
  • tab_contentobject[]
    包含各种尺码内容数据的 tab 分栏数据体。
    最大个数限制:10
  • cross_table_contentobject
    交叉表格类型的数据体,常用于显示不同身体参数适合的具体尺码。例如身高170cm,体重70kg适用L。
  • column_title string
    交叉表格中列的标题,用于说明列的数据代表的尺码信息。例如 weight 表示列的数据为体重数据。默认为 weight
    最大长度限制:20
    Example: weight
  • column_unitobject
    交叉表格中列的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 kg
    Example: kg
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 lb
    Example: lb
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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
    交叉表格的备注。
    最大长度限制:255
    Example: 1 lb = 0.45 kg,1 feet = 30.48 cm
  • row_title string
    交叉表格中行的标题,用于说明行的数据代表的尺码信息。例如 height 表示行的数据为身高数据。
    默认为 height
    最大长度限制:20
    Example: height
  • row_unitobject
    交叉表格中行的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 feet
    Example: feet
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
    Example: cm
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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[] required
    交叉表格数据体,第一个元素为表头,数组中的每个元素对应表格中的一行数据。
    最大行数限制:50
  • row_data array required
    交叉表格数据体,第一个元素为表头, 数组中的每个元素对应表格中的一行数据。
    最大行数限制:50
    Example: XS,64
  • table_contentobject
    表格类型的数据体,常用于以表格形式显示尺码数据。例如 S 的肩宽是60,腰围是55。
  • country_sizeobject
    国家尺码数据,代表此表格内的尺码在不同国家下的名称。
  • country_size_dataobject[] required
    国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。
  • country string required
    国家名称。
    最大长度限制:19
    Example: US
  • data array required
    表格中不同尺码在当前国家的名称数组。
    最大个数限制:21
    数组中每个元素最大长度限制:19
    Example: 78,89
  • cover_attribute boolean
    是否覆盖尺码规格文案,传入 true 时将使用国家尺码名称替代页面上的尺码属性值进行展示。
    true:表示覆盖
    false:表示不覆盖
    默认取值为 false
  • status boolean
    是否开启国家尺码功能开关。
    true:表示开启功能
    false:表示不开启功能
    默认值为:false
    Example: true
  • remark string
    表格备注。
    最大长度限制:255
    Example: 1inch=2.54cm
  • size_dataobject[] required
    表格数据体,一个数组代表表格的一行数据,第一个数组为表头,数组中的每个元素对应表格中的单元格数据。
    最大行数限制:50
  • row_data array required
    数组形式的表格行数据,数组中每个元素代表一个单元格。
    每个数组最大元素数量:50
    每个元素最大长度限制:19
    Example: XS,64
  • unitobject
    表格的尺码数据使用的单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 in
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
  • unit_type string
    表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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 数据体,tab 可以嵌套在 tab 下形成二级 tab 的效果,最多嵌套2级,可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。
    最大tab分栏数量限制:5
  • tab_contentobject[]
    二级 tab 数据体,tab 可以嵌套在 tab 下形成二级 tab 的效果,最多嵌套2级,可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。
    最大tab分栏数量限制:5
  • cross_table_contentobject
    交叉表格类型的数据体,常用于显示不同身体参数适合的具体尺码。例如身高170cm,体重70kg适用L。
  • column_title string
    交叉表格中列的标题,用于说明列的数据代表的尺码信息。例如 weight 表示列的数据为体重数据。默认为 weight
    最大长度限制:20
    Example: weight
  • column_unitobject
    交叉表格中列的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 kg
    Example: kg
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 lb
    Example: lb
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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
    交叉表格的备注。
    最大长度限制:255
    Example: 1 lb = 0.45 kg,1 feet = 30.48 cm
  • row_title string
    交叉表格中行的标题,用于说明行的数据代表的尺码信息。例如 height 表示行的数据为身高数据。
    默认为 height
    最大长度限制:20
    Example: height
  • row_unitobject
    交叉表格中行的尺码单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 feet
    Example: feet
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
    Example: cm
  • unit_type string
    交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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[] required
    交叉表格数据体,第一个元素为表头,数组中的每个元素对应表格中的一行数据。
    最大行数限制:50
  • row_data array required
    交叉表格行数据,数组中每个元素为一行数据中的一个单元格。
    每行最大单元格数:50
    每个单元格最大长度限制:19
    Example: XS,64
  • table_contentobject
    表格类型的数据体,常用于以表格形式显示尺码数据。例如 S 的肩宽是60,腰围是55。
  • country_sizeobject
    国家尺码数据,代表此表格内的尺码在不同国家下的名称。
  • country_size_dataobject[] required
    国家尺码数据, 数组的第一个元素代表国家,其他元素代表不同尺码在这个国家的名称。
  • country string required
    国家名称。
    最大长度限制:19
    Example: US
  • data array required
    表格中不同尺码在当前国家的名称数组。
    数组中每个元素最大长度限制:19
    Example: 78,89
  • cover_attribute boolean
    是否覆盖尺码规格文案,传入 true 时将使用国家尺码名称替代页面上的尺码属性值进行展示。
    true:表示覆盖
    false:表示不覆盖
    默认取值为 false
  • status boolean
    是否开启国家尺码功能开关。
    true:表示开启功能
    false:表示不开启功能
    默认取值为false
    Example: true
  • remark string
    表格备注。
    最大长度限制:255
    Example: 1inch=2.54cm
  • size_dataobject[] required
    表格数据体,一个数组代表表格的一行数据,第一个数组为表头,数组中的每个元素对应表格中的单元格数据。
    最大行数限制:50
  • row_data array required
    数组形式的表格行数据,数组中每个元素代表一个单元格。
    每个数组最大元素数量:50
    每个元素最大长度限制:19
    Example: XS,64
  • unitobject
    表格的尺码数据使用的单位。
  • convert_unit string
    尺码数据的可选展示单位。客户可以在默认单位(default_unit)和此单位之间切换展示尺码。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。默认为 in
    Example: in
  • default_unit string
    尺码数据的默认展示单位。 该字段有效值请参考 unit_type 描述中的表格信息,你需要根据指定的 unit_type 传入支持的单位。 ,默认为 cm
    Example: cm
  • unit_type string
    表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有:
    • LENGTH :长度类型单位
    • WEIGHT(默认):重量类型单位
    • BULK:体积类型单位
    每一种类型下支持的单位枚举如下:
    单位类型单位类型描述支持单位支持单位描述
    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
  • text string
    文本类型内容。
    Example: My SizeChart
  • title string
    尺码表格标题,超过长度限制会被截断。
    最大长度限制:50
  • type string required
    二级 tab 中支持的内容类型枚举,枚举值如下所示:
    • SIZE_CHART:表格类型
    • CROSS_SIZE_CHART:交叉表格类型
    • IMAGE:图片类型
    • TEXT:文本类型
  • url string
    图片类型内容,当 type 传入 IMAGE 时,传入图片的 URL 地址。
  • tab_name string required
    tab 分栏的名称。
    最大长度限制:50
  • text string
    文本类型内容。
    Example: My SizeChart
  • title string
    尺码表格标题,超过长度限制会被截断。
    最大长度限制:50
    Example: Size Chart
  • type string required
    tab 中支持的内容类型枚举,枚举值如下所示:
    • SIZE_CHART:表格类型
    • CROSS_SIZE_CHART:交叉表格类型
    • IMAGE:图片类型
    • TEXT:文本类型
    • TAB:Tab类型
    Example: SIZE_CHART
  • url string
    图片类型内容,当 type 传入 IMAGE 时,传入图片的 URL 地址。
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • tab_name string required
    tab 分栏的名称。
    最大长度限制:50
  • text string
    文本类型内容。
    Example: My SizeChart
  • title string
    尺码表标题,超过长度限制会被截断。
    最大长度限制:50
    Example: Size Chart
  • type string required
    尺码表中支持的内容类型枚举,枚举值如下所示:
    • SIZE_CHART:表格类型
    • CROSS_SIZE_CHART:交叉表格类型
    • IMAGE:图片类型
    • TEXT:文本类型
    • TAB:Tab 类型
    Example: SIZE_CHART
  • url string
    图片类型内容,当 type 传入 IMAGE 时,传入图片的 URL 地址。
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • language_scope string
    将尺码表与语言进行匹配的方法类型,当language_scope=SPECIFIC 时,languages 不能为空,需通过 languages 指定支持的语言。枚举值类型如下:
    • ALL: 全部语言
    • SPECIFIC: 指定语言
    默认为: ALL
    Example: ALL
  • 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: EN,CN
  • product_list array
    applicable_product_type 传入 SPECIFIC 时,使用此字段传入尺码表匹配的商品 ID 列表。
    最大数量限制:100
    Example: 16064649853088531841170520
  • size_chart_id string required
    尺码表的唯一 ID。
    Example: 13266288837293171311580520
  • status boolean
    尺码表的发布状态。
    • true: 表示发布尺码表
    • false: 表示不发布尺码表
    默认值为:false
  • title string
    尺码表标题,超过最大长度限制会被截断。
    最大长度限制:100
    Example: My SizeChart
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • dataobject
    响应数据。
  • size_chart_id string
    尺码表 ID。
    Example: 13266288837293171311580520
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

header required

Body

required
{
  "req": {
    "applicable_attribute_list": [
      "size"
    ],
    "applicable_product_type": "ALL",
    "collection_list": [
      "12260895952237462871473144"
    ],
    "contents": [
      {
        "cross_table_content": {
          "column_title": "weight",
          "column_unit": {
            "convert_unit": "kg",
            "default_unit": "lb",
            "unit_type": "WEIGHT"
          },
          "remark": "1 lb = 0.45 kg,1 feet = 30.48 cm",
          "row_title": "height",
          "row_unit": {
            "convert_unit": "feet",
            "default_unit": "cm",
            "unit_type": "LENGTH"
          },
          "size_data": [
            {
              "row_data": [
                "XS,64"
              ]
            }
          ]
        },
        "table_content": {
          "country_size": {
            "country_size_data": [
              {
                "country": "United States",
                "data": [
                  "78,89"
                ]
              }
            ],
            "cover_attribute": false,
            "status": true
          },
          "remark": "1inch=2.54cm",
          "size_data": [
            {
              "row_data": [
                "XS,64"
              ]
            }
          ],
          "unit": {
            "convert_unit": "in",
            "default_unit": "cm",
            "unit_type": "LENGTH"
          }
        },
        "tabs": [
          {
            "tab_content": [
              {
                "cross_table_content": {
                  "column_title": "weight",
                  "column_unit": {
                    "convert_unit": "kg",
                    "default_unit": "lb",
                    "unit_type": "WEIGHT"
                  },
                  "remark": "1 lb = 0.45 kg,1 feet = 30.48 cm",
                  "row_title": "height",
                  "row_unit": {
                    "convert_unit": "feet",
                    "default_unit": "cm",
                    "unit_type": "LENGTH"
                  },
                  "size_data": [
                    {
                      "row_data": [
                        "XS,64"
                      ]
                    }
                  ]
                },
                "table_content": {
                  "country_size": {
                    "country_size_data": [
                      {
                        "country": "US",
                        "data": [
                          "78,89"
                        ]
                      }
                    ],
                    "cover_attribute": false,
                    "status": true
                  },
                  "remark": "1inch=2.54cm",
                  "size_data": [
                    {
                      "row_data": [
                        "XS,64"
                      ]
                    }
                  ],
                  "unit": {
                    "convert_unit": "",
                    "default_unit": "",
                    "unit_type": ""
                  }
                },
                "tabs": [
                  {
                    "tab_content": [
                      {
                        "cross_table_content": {
                          "column_title": "weight",
                          "column_unit": {
                            "convert_unit": "kg",
                            "default_unit": "lb",
                            "unit_type": "WEIGHT"
                          },
                          "remark": "1 lb = 0.45 kg,1 feet = 30.48 cm",
                          "row_title": "height",
                          "row_unit": {
                            "convert_unit": "feet",
                            "default_unit": "cm",
                            "unit_type": "LENGTH"
                          },
                          "size_data": [
                            {
                              "row_data": [
                                "XS,64"
                              ]
                            }
                          ]
                        },
                        "table_content": {
                          "country_size": {
                            "country_size_data": [
                              {
                                "country": "US",
                                "data": [
                                  "78,89"
                                ]
                              }
                            ],
                            "cover_attribute": false,
                            "status": true
                          },
                          "remark": "1inch=2.54cm",
                          "size_data": [
                            {
                              "row_data": [
                                "XS,64"
                              ]
                            }
                          ],
                          "unit": {
                            "convert_unit": "in",
                            "default_unit": "cm",
                            "unit_type": "LENGTH"
                          }
                        },
                        "text": "My SizeChart",
                        "title": "",
                        "type": "",
                        "url": ""
                      }
                    ],
                    "tab_name": ""
                  }
                ],
                "text": "My SizeChart",
                "title": "Size Chart",
                "type": "SIZE_CHART",
                "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
              }
            ],
            "tab_name": ""
          }
        ],
        "text": "My SizeChart",
        "title": "Size Chart",
        "type": "SIZE_CHART",
        "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
      }
    ],
    "language_scope": "ALL",
    "languages": [
      "EN,CN"
    ],
    "product_list": [
      "16064649853088531841170520"
    ],
    "size_chart_id": "13266288837293171311580520",
    "status": false,
    "title": "My SizeChart"
  }
}

Language

curl --request PUT \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/sizechart.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json'
Examples
更新尺码表
Request
{
"req": {
"applicable_attribute_list": [
"size"
],
"applicable_product_type": "SPECIFIC",
"collection_list": null,
"contents": [
{
"cross_table_content": null,
"table_content": {
"country_size": null,
"remark": "1inch=2.54cm",
"size_data": [
{
"row_data": [
"SIZE",
"LENGTH",
"BUST",
"SHOULDER",
"SLEEVE"
]
},
{
"row_data": [
"XS",
"64",
"91",
"35",
"53"
]
},
{
"row_data": [
"S",
"66",
"94",
"35.5",
"56"
]
},
{
"row_data": [
"M",
"69",
"96",
"36.5",
"58"
]
},
{
"row_data": [
"L",
"71",
"98",
"38",
"60"
]
}
],
"unit": {
"convert_unit": "in",
"default_unit": "cm",
"unit_type": "LENGTH"
}
},
"tabs": null,
"text": null,
"title": "Size Chart",
"type": "SIZE_CHART",
"url": null
},
{
"cross_table_content": null,
"table_content": null,
"tabs": null,
"text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
"title": null,
"type": "TEXT",
"url": null
},
{
"cross_table_content": null,
"table_content": null,
"tabs": null,
"text": null,
"title": null,
"type": "IMAGE",
"url": "https://cdn.myshopline.com/image/size-chart/detail/content_model.png"
},
{
"cross_table_content": {
"column_title": "weight",
"column_unit": {
"convert_unit": "kg",
"default_unit": "lb",
"unit_type": "WEIGHT"
},
"remark": null,
"row_title": "height",
"row_unit": {
"convert_unit": "feet",
"default_unit": "cm",
"unit_type": "LENGTH"
},
"size_data": [
{
"row_data": [
"",
"170-180",
"180-190",
"190-200"
]
},
{
"row_data": [
"60-70",
"L",
"XL",
"XXL"
]
},
{
"row_data": [
"70-80",
"XL",
"XL",
"XXL"
]
},
{
"row_data": [
"80-90",
"XXL",
"XXL",
"XXL"
]
}
]
},
"table_content": null,
"tabs": null,
"text": null,
"title": "Cross Size Chart",
"type": "CROSS_SIZE_CHART",
"url": null
},
{
"cross_table_content": null,
"table_content": null,
"tabs": [
{
"tab_content": [
{
"cross_table_content": null,
"table_content": null,
"tabs": [
{
"tab_content": [
{
"cross_table_content": null,
"table_content": {
"country_size": null,
"remark": "1inch = 2.54cm",
"size_data": [
{
"row_data": [
"SIZE",
"UNDER BUST",
"CUP HEIGHT"
]
},
{
"row_data": [
"S",
"24.4",
"5.3"
]
},
{
"row_data": [
"M",
"26",
"5.7"
]
},
{
"row_data": [
"L",
"27.6",
"6.2"
]
}
],
"unit": {
"convert_unit": "in",
"default_unit": "cm",
"unit_type": "LENGTH"
}
},
"text": null,
"title": "Size Chart",
"type": "SIZE_CHART",
"url": null
},
{
"cross_table_content": null,
"table_content": null,
"text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
"title": null,
"type": "TEXT",
"url": null
}
],
"tab_name": "TOP"
},
{
"tab_content": [
{
"cross_table_content": null,
"table_content": {
"country_size": null,
"remark": "1inch = 2.54cm",
"size_data": [
{
"row_data": [
"SIZE",
"bottom length\t",
"bottom waist"
]
},
{
"row_data": [
"S",
"31.7-8.7",
"22.0"
]
},
{
"row_data": [
"M",
"32.1-9.1",
"23.6"
]
},
{
"row_data": [
"L",
"32.5-9.4",
"25.2"
]
}
],
"unit": {
"convert_unit": "in",
"default_unit": "cm",
"unit_type": "LENGTH"
}
},
"text": null,
"title": "Size Chart",
"type": "SIZE_CHART",
"url": null
},
{
"cross_table_content": null,
"table_content": null,
"text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
"title": null,
"type": "TEXT",
"url": null
}
],
"tab_name": "BOTTOM"
}
],
"text": null,
"title": null,
"type": "TAB",
"url": null
}
],
"tab_name": "Product Measurements"
},
{
"tab_content": [
{
"cross_table_content": null,
"table_content": null,
"tabs": null,
"text": null,
"title": null,
"type": "IMAGE",
"url": "https://d2n979dmt31clo.cloudfront.net/image/rule/1709518999861/dce7fffb9108427a854708b7379d8346.png?w=1740&h=1317"
}
],
"tab_name": "Body Measurements"
}
],
"text": null,
"title": null,
"type": "TAB",
"url": null
}
],
"language_scope": "SPECIFIC",
"languages": [
"en"
],
"product_list": [
"16067821420558192659742275"
],
"size_chart_id": "13268300202703737403692275",
"status": true,
"title": "sizechart_en"
}
}
Response
{
"data": {
"size_chart_id": "13268300202703737403692275"
}
}
这篇文章对你有帮助吗?