Naming Conventions

Understand how our data is organized and put at your disposal to benefit the most of our automated features

Products

All our products can be uniquely identified by using their SKU reference which is built as follows:

{StyleCode} {VariantCode}

Example:

STTM528C0011L


{StyleCode} is a 7 character string

Example:

STTM528


{VariantCode} is a 6 character string

Example:

C0011L

The variant code is made of two parts, being

  • {ColorCode}, a 4 character string (example C001).

  • {SizeCodeNav}, a 2 character string (example : 1L)


How to get access to our product data?

You can access our product data by several means:

  • CSV file

    • Download a CSV file containing all attributes of our products. You can either download all our products or filter which products to download using several criteria's (like language, style code, etc).

  • JSON/REST V1 web service

    • This web service lets you download all attributes of our products. Each record is a variant (style+color+size). You can also filter which products to download using several criteria's (like language, style code, etc).

  • JSON/REST V2 web service

    • This web service is similar to JSON/REST V1 but groups the variants by styles. Attributes that are common for all variants of a style are represented only once.

See the Products API page for more information about our Products API's.


Product images

All our pictures can be uniquely identified by using their name, which is built as follows.

{PhotoCode}_{StyleCode}_{ColorCode}.jpg

Example:

PFM0_STTM528_C001.jpg

{PhotoCode} is a 4 character code that identifies the type of the photo.

  • The first character indicates if the picture is a Packshot or a Studio photo

  • The second character indicates if the picture is shot from Front, Back or Side

  • The third character indicates if the picture is a Main or Detail

  • The last character is the sequence (a number from 0 to 9)

    • For unisex products, studio pictures from 0 to 4 are men pictures and from 5 to 9 women pictures.

In the above example, we can thus know that the picture we call is a packshot, shooted from front - and we know we will have a full image of the product.

{StyleCode} is a 7 character string. It is the same code used in the SKU

{ColorCode}, a 4 character string. It is the same code used in the SKU.

The photo code does not contain any information regarding the size of the product.

All pictures are provided in *.jpg format. 

The pictures are available in 2 different sizes:

  • High Definition: The size of the pictures is XXX

  • Web Definition: The size of the pictures is XXX

How to get access to our product pictures?

All pictures are available in the following repositories:

  • High Definition : https://api.stanleystella.com/Pictures

  • Low Defition : https://api.stanleystella.com/Pictures-LD

We recommend you to take local copies of our pictures and not to link directly to our server. If you do, you may experience performance issues.

You can retrieve the list of all pictures in two ways:

  • CSV file

    • Download a CSV file containing the list of pictures and their attributes (f.ex URL, name, type, etc).

  • JSON/REST web service

    • This web service lets you download the list of pictures and their attributes. You can either download the whole list of filter the pictures using several criteria's (f.ex style code, color code, etc).

 

See the Product Images API page for more information about our Product Images API.

Colours & Colour Bullets

As already mentionned here above, each color is identified by a 4 characters long code.

Example:

C001 is the code for the colour White

How to get access to our colours and colour bullets?

You can retrieve the list of all our colours using:

  • JSON/REST web service

    • This web service lets you download the list of colours and their attributes (code, name, sequence, etc). This web service can be useful when integrating our API with ecommerce platform requiring to first import the list of colour and size options before importing the variants.

You can retrieve the colour bullets in two ways:

  • One by one: Using the color code, you can retrieve our colour bullet as a PNG file.

    • The url where the colour bullets are is: https://api.stanleystella.com/Colours/{ColourCode}.png

    • Example:

    https://api.stanleystella.com/Colours/C001.png
  • All at once: you can download a single archive containing all colour bullets

 

See the Colours API page for more information about our Colours API.

Sizes

As already mentionned here above, each size is identified by a 2 characters long code. 

Example:

1M is the code for the size M

How to get access to our sizes?

You can retrieve the list of all our sizes using:

  • JSON/REST web service

    • This web service lets you download the list of sizes and their attributes (code, name, sequence, etc). This web service can be useful when integrating our API with ecommerce platform requiring to first import the list of colour and size options before importing the variants.

 

See the Sizes API page for more information about our Sizes API.