Changes for page Design Details

Last modified by Shop Team on 2023/02/13 22:56
From version 1.1 >
edited by Shop Team
on 2019/08/01 11:55
To version < 12.1
edited by Shop Team
on 2023/02/13 22:56
Change comment: Renamed back-links.

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Design
1 +Design Details
Parent
... ... @@ -1,0 +1,1 @@
1 +API.Spreadshirt Public Shop API Documentation.API REST Resources.WebHome
Content
... ... @@ -1,5 +1,6 @@
1 -= List of all designs in the shop =
1 +In our terminology, a design represents a pixel (png, jpg, gif) or vector image (svg) that you uploaded in the Partner Area. Every entry from the [[Sellables endpoint>>doc:API.Spreadshirt Public Shop API Documentation.API REST Resources.Sellables.WebHome]] contains a field "mainDesignId". This id can be used to access the resource below in order to retrieve additional information about the upload. In the vast majority of implementations, this information is not necessary and it suffices to use the "Sellables" resource.
2 2  
3 +(% class="wrapped" %)
3 3  |=(((
4 4  Method
5 5  )))|=(((
... ... @@ -10,71 +10,70 @@
10 10  |(((
11 11  GET
12 12  )))|(((
13 -/api/v1/shops/<shopId>/designs
14 +/api/v1/shops/<shopId>/designs/<designId>
14 14  )))|(((
15 -[[https:~~/~~/api.spreadshirt.net/api/v1/shops/100488332/designs?mediaType=json>>url:https://api.spreadshirt.net/api/v1/shops/100488332/designs?mediaType=json||shape="rect"]]
16 +[[https:~~/~~/api.spreadshirt.net/api/v1/shops/100488332/designs/163261757?mediaType=json>>url:https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757?mediaType=json||shape="rect"]]
16 16  )))
17 17  
18 18  \\
19 19  
21 +A design has the following characteristics:
22 +
23 +* Each design has a name, a description, a size.
24 +* **Images:** To retrieve a design image, you can use a URL similar to the following one: [[https:~~/~~/image.spreadshirtmedia.net/image-server/v1/designs/2484607>>url:https://image.spreadshirtmedia.net/image-server/v1/designs/2484607||shape="rect"]]. These URLs are provided within the resources part of the design payload.
25 +* **Color Layers:** Vector designs consist of one or more color layers. We provide for each color layer, the original color of the uploaded design as well as the color set by the owner as actual default color. Example:
26 +[[image:attach:design-layer2.png]]
27 +\\
28 +* **Allowed Print Types:** For each design, we provide a list of print types, e.g. flock, flex or digital direct print, that can be used to print that design. Vector and pixel images are printed using different print types!
29 +
30 +\\
31 +
20 20  {{code language="js" title="Example Payload"}}
21 21  {
22 - "sortField":"default",
23 - "sortOrder":"default",
24 - "offset":0,
25 - "limit":10,
26 - "count":2,
27 - "designs":[
34 + "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
35 + "id":"163261757",
36 + "created":"2019-07-08T08:03:56.000+0000",
37 + "modified":"2019-07-22T10:17:39.000+0000",
38 + "name":"I love you",
39 + "description":"A lovely design for you",
40 + "tags":"Love,Love hurts,Love me,Love parade,Love with heart,Loved,Lovestruck,You,Young money,Young wild and free,Your,Youtube,migration,shop api,test",
41 + "user":{
42 + "href":"https://api.spreadshirt.net/api/v1/users/117878306",
43 + "id":"117878306"
44 + },
45 + "size":{
46 + "width":3938.0,
47 + "height":1149.0,
48 + "unit":"px"
49 + },
50 + "colors":[
51 +
52 + ],
53 + "backgroundColor":"#666666",
54 + "printTypes":[
28 28   {
29 - "id":"163261757",
30 - "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
31 - "name":"I love you",
32 - "price":{
33 - "vatIncluded":0.0,
34 - "vatExcluded":0.0,
35 - "vat":0.0,
36 - "currency":{
37 - "id":"1",
38 - "href":"https://api.spreadshirt.net/api/v1/currencies/1"
39 - }
40 - },
41 - "backgroundColor":"#666666",
42 - "resources":[
43 - {
44 - "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757",
45 - "mediaType":"png",
46 - "type":"preview"
47 - }
48 - ],
49 - "version":1562573036
56 + "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/17",
57 + "id":"17"
50 50   },
51 51   {
52 - "id":"163261722",
53 - "href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261722",
54 - "name":"pinguine",
55 - "price":{
56 - "vatIncluded":0.0,
57 - "vatExcluded":0.0,
58 - "vat":0.0,
59 - "currency":{
60 - "id":"1",
61 - "href":"https://api.spreadshirt.net/api/v1/currencies/1"
62 - }
63 - },
64 - "resources":[
65 - {
66 - "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261722",
67 - "mediaType":"png",
68 - "type":"preview"
69 - }
70 - ],
71 - "version":1562573036
60 + "href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/1",
61 + "id":"1"
72 72   },
73 - ]
63 + ],
64 + "resources":[
65 + {
66 + "mediaType":"png",
67 + "type":"preview",
68 + "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757,backgroundColor=666666"
69 + },
70 + {
71 + "mediaType":"png",
72 + "type":"montage",
73 + "href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757"
74 + }
75 + ],
74 74  }
75 75  {{/code}}
76 76  
77 77  (% class="auto-cursor-target" %)
78 78  \\
79 -
80 -\\
design-layer2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +31.8 KB
Content
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -28278859
1 +28278856
url
... ... @@ -1,1 +1,1 @@
1 -https://developer.spreadshirt.net/wiki/spaces/API/pages/28278859/Design
1 +https://developer.spreadshirt.net/wiki/spaces/API/pages/28278856/Design Details

Navigation