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 above. A product type has the following characteristics:
- Each product type has a set of core data, such as name description and price.
- 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 trousers. 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
For product types, we deliver the following images:
- Product Type View Images: Product type view images display product types from different viewers perspectives, e.g. front, back, left or right. The most left image in the image list above illustrates such a view image. A sample URL is: https://image.spreadshirtmedia.net/image-server/v1/productTypes/101/views/1/appearances/33,width=200,height=200.jpg
- Product Type Size Images: Product type size images illustrates the different product type measures, e.g. arm length, total length or waist size, in an image. The image in the center of the image list above illustrates that. A sample URL is: https://image.spreadshirtmedia.net/image-server/v1/productTypes/101/variants/size.jpg
- Product Type Detail Images: Product type detail images show how a product type looks like, when worn by a person. The most right image illustrates that. A sample URL is: https://image.spreadshirtmedia.net/image-server/v1/productTypes/101/variants/detail.jpg
- Product Type Appearance Images: The image API also returns images for product type appearance, aka product type color/pattern combinations. A sample appearance image is illustrated in the image above. A sample URL is: https://image.spreadshirtmedia.net/image-server/v1/appearances/4.jpg
- Print Color Images: The image API also returns images for print colors. A sample color image is illustrated in the image above. A sample URL is: https://image.spreadshirtmedia.net/image-server/v1/printColors/4,width=200,height=200.jpg
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).
The returned payload provides you with extension information about the given ProductType: