Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

General

In our terminology, a product type represents the pure piece or apparel, e.g. a T-shirt, as we get it from our supplier, e.g. American Apparel. A typical product type, e.g. a yellow T-shirt from American Apparel in size M, is illustrated in the picture abovebelow. A product type has the following characteristics:

...

  • Each product type has a set of core data, such as name description and price.Image Added
  • Appearances: A product type has one or more appearances. An appearance describes a pattern/color combination for a piece of apparel, e.g. a yellow T-shirt (no pattern/yellow color) or a camouflage T-shirt (camouflage pattern/light green and dark green as colors). It's important to understand that we are not able to print with each available print type, e.g. flock, flex or digital direct, on each available product type. Therefore, we define for each appearance, which print types are allowed.
  • Sizes: A product type has one or more sizes, such as S, M or L. Please note, that size information may vary between different product types. Sizes for adults are for example different from sizes for babys or kids.
  • StockStates: Each product type provides stock state information for all allowed appearance/size combinations. We tell you for each combination, whether we have that in stock or not.
  • Views: Views describe from which position a human being can look on a specific piece of apparel. Each product type has at least one view. The most common views are apparent: one can look on a piece of apparel from front, back, left and right. However, less apparent is that specific product types have hoods which adds two other views: hood left and hood right. Views for shirts are also different from views for trouserspants. And last but not least, one can also print on the inside areas of certain shirts, e.g. basketball shirts, which adds another set of possible views.
  • PrintAreas: Print areas describe those parts on a piece of apparel on which we can actually print text and designs using different print types and print colors. Print areas are usually rectangular. However, there are cases where rectangular print area descriptions are not sufficient, for example for T-shirts with v-neck. Another issue is that there might be knobs, pockets or zippers on a T-shirt on which we cannot print - and which we also need to describe. That's the reason why our print area model contains a hard boundary and soft boundary description for each print area. The hard boundary describes the shape inside which one has to position ones text and designs. The soft boundary describes all things inside the hard boundary on which we can't print, e.g. zipper.
    Images: To retrieve a product type image, you can use a URL similar to the following one: https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/411. It is important to understand, that these URLs are provided with the resources parts of the product type XML description:

ProductType Images

Image AddedImage AddedImage Added

For product types, we deliver the following images:

Resource

While a list resource exists it is recommended to retrieve only the ProductType that is required to display a product. In order to internationalize the returned payload it is possible to specify a locale query parameter (example: locale=de_DE for german).

MethodURLExample
GET/api/v1/shops/<shopId>/productTypes/<productTypeId>https://api.spreadshirt.net/api/v1/shops/100488332/productTypes/812?mediaType=json

...