Get product customization config

GET 
/openapi/2027-01/customization/products/:product_id/design

Returns the customization configuration of a product, including components, groups and conditions.

Request

Path Parameters

product_id stringrequired

SaaS product ID

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

design object

Product customization configuration

product_idstring

SaaS product ID

typestring

Config type: normal / linked (read only)

applied_template_idstring

Source template ID, empty when not applied from a template

components object[]

Customization items

Array [

keystring

Component key, format {type}-{8 chars}, unique within one configuration

typestring

Component type: text / dropdown / checkbox / button / image / upload / datetime / size-pricing / preview-*

settingsobject

Component settings. Common fields: label (required, unique within a product), order_label, required, support_condition, value, options[]; options[]: key (option identifier, used by ERP to match), label, value, imageUrl, price, link, children, parentKey; remaining fields depend on type

price_settings object

Pricing rule of this component

calc_typestring

Calculation type: component / option / bysize / formula

price object

Price map. Key is the component key when calc_type=component, the option key when option, the size key when bysize

property name*double

settingsobject

Extra settings, contains formula when calc_type=formula

]

groups object[]

Component groups

Array [

keystring

Group key

group_namestring

Group display name

containsstring[]

Keys of the components contained in this group

typestring

Group type: material (each component's default wrapping group, key equals the component key) / group (custom group, key looks like group-xxxxxxxx)

]

conditions object[]

Chained display rules

Array [

rulesobject

{items: [{type: custom/product, left, right: []}], logic: and/or}. For custom: left is a component key, right is an option key; for product: left is a variant option name, right is a variant option value

targetsstring[]

Keys of the components or groups to show

]

with_previewint32

Preview mode: 0-options only, 1-with preview

preview_settings object

Preview settings, present when with_preview is 1

physical_sizeobject

{width, height, unit, dpi}

background_imagesobject

{[saas_variant_id]: {image: {src, width, height}}}

print_design_boundingobject

{[saas_variant_id]: {top, left, width, height, angle, scaleX, scaleY}}

layersGoogleProtobufValue

Layers definition

artwork_image object

Artwork image

srcstring

Image URL

widthint32

Image width in pixels

heightint32

Image height in pixels

Example

json

{
  "code": "string",
  "message": "string",
  "data": {
    "design": {
      "product_id": "string",
      "type": "string",
      "applied_template_id": "string",
      "components": [
        {
          "key": "string",
          "type": "string",
          "settings": {},
          "price_settings": {
            "calc_type": "string",
            "price": {},
            "settings": {}
          }
        }
      ],
      "groups": [
        {
          "key": "string",
          "group_name": "string",
          "contains": [
            "string"
          ],
          "type": "string"
        }
      ],
      "conditions": [
        {
          "rules": {},
          "targets": [
            "string"
          ]
        }
      ],
      "with_preview": 0,
      "preview_settings": {
        "physical_size": {},
        "background_images": {},
        "print_design_bounding": {},
        "artwork_image": {
          "src": "string",
          "width": 0,
          "height": 0
        }
      }
    }
  }
}