Changes for page Sellables

Last modified by Shop Team on 2023/02/13 22:56

<
From version < 4.1 >
edited by Shop Team
on 2019/07/18 07:55
To version < 6.1 >
edited by Shop Team
on 2019/07/18 09:34
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -42,7 +42,7 @@
42 42  
43 43  == Client / Server ==
44 44  
45 -All requests to the *Public Shop API* should be made from your server and not from the browser. This allows you to leverage caching, avoids CORS policy interference and keeps your API key secure.
45 +All requests to the **Public Shop API** should be made from your server and not from the browser. This allows you to leverage caching, avoids [[CORS>>url:https://en.wikipedia.org/wiki/Cross-origin_resource_sharing||shape="rect"]] policy interference and keeps your API key secure.
46 46  
47 47  == List Resource ==
48 48  
... ... @@ -59,52 +59,52 @@
59 59  
60 60  {{code language="js" title="Response Payload"}}
61 61  {
62 -"count" : 473,
63 -"limit" : 48,
64 -"offset" : 0,
65 -"sellables" :
66 -[
67 -{
68 -"sellableId" : "74bYwmw5a3tXgyZpnw7j-812-7",
69 -"ideaId" : "5c7e78f95fd3e45786249fb0",
70 -"productTypeId" : "812",
71 -"price" :
72 -{
73 -"amount" : 21.99,
74 -"currencyId" : "1"
75 -},
76 -"name" : "Boss in black",
77 -"description" : "Be your own boss in black and printed by real people in black!",
78 -"tags" :
79 -[
80 -"Fanwear",
81 -"SpreadShop",
82 -"Awesome"
83 -],
84 -"previewImage" :
85 -{
86 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=500,height=500,appearanceId=1,crop=list,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
87 -"type" : "MODEL"
88 -},
89 -"appearanceIds" :
90 -[
91 -"411",
92 -"645",
93 -"649",
94 -"1",
95 -"366",
96 -"92",
97 -"39",
98 -"231",
99 -"317",
100 -"3",
101 -"29",
102 -"328"
103 -],
104 -"defaultAppearanceId" : "1"
105 -},
106 -// more sellables
107 -]
62 + "count" : 473,
63 + "limit" : 48,
64 + "offset" : 0,
65 + "sellables" :
66 + [
67 + {
68 + "sellableId" : "74bYwmw5a3tXgyZpnw7j-812-7",
69 + "ideaId" : "5c7e78f95fd3e45786249fb0",
70 + "productTypeId" : "812",
71 + "price" :
72 + {
73 + "amount" : 21.99,
74 + "currencyId" : "1"
75 + },
76 + "name" : "Boss in black",
77 + "description" : "Be your own boss in black and printed by real people in black!",
78 + "tags" :
79 + [
80 + "Fanwear",
81 + "SpreadShop",
82 + "Awesome"
83 + ],
84 + "previewImage" :
85 + {
86 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=500,height=500,appearanceId=1,crop=list,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
87 + "type" : "MODEL"
88 + },
89 + "appearanceIds" :
90 + [
91 + "411",
92 + "645",
93 + "649",
94 + "1",
95 + "366",
96 + "92",
97 + "39",
98 + "231",
99 + "317",
100 + "3",
101 + "29",
102 + "328"
103 + ],
104 + "defaultAppearanceId" : "1"
105 + },
106 + // more sellables
107 + ]
108 108  }
109 109  {{/code}}
110 110  
... ... @@ -195,86 +195,86 @@
195 195  
196 196  {{code language="js" title="Response Payload"}}
197 197  {
198 -"sizeIds" :
199 -[
200 -"2",
201 -"3",
202 -"4",
203 -"5",
204 -"6",
205 -"38",
206 -"94",
207 -"102"
208 -],
209 -"images" :
210 -[
211 -{
212 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411,crop=detail,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
213 -"type" : "MODEL"
214 -},
215 -{
216 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/2,width=650,height=650,appearanceId=411,crop=detail,modelId=91,version=1554885805/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
217 -"type" : "MODEL"
218 -},
219 -{
220 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/compositions/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
221 -"type" : "DESIGN"
222 -},
223 -{
224 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/compositions/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/2,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
225 -"type" : "DESIGN"
226 -},
227 -{
228 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/3,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
229 -"type" : "PRODUCT"
230 -},
231 -{
232 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/4,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
233 -"type" : "PRODUCT"
234 -},
235 -{
236 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411,crop=detail,modelId=1111,version=1554884899/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
237 -"type" : "ALTERNATIVE_MODEL"
198 + "sizeIds" :
199 + [
200 + "2",
201 + "3",
202 + "4",
203 + "5",
204 + "6",
205 + "38",
206 + "94",
207 + "102"
208 + ],
209 + "images" :
210 + [
211 + {
212 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411,crop=detail,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
213 + "type" : "MODEL"
214 + },
215 + {
216 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/2,width=650,height=650,appearanceId=411,crop=detail,modelId=91,version=1554885805/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
217 + "type" : "MODEL"
218 + },
219 + {
220 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/compositions/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
221 + "type" : "DESIGN"
222 + },
223 + {
224 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/compositions/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/2,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
225 + "type" : "DESIGN"
226 + },
227 + {
228 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/3,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
229 + "type" : "PRODUCT"
230 + },
231 + {
232 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/4,width=650,height=650,appearanceId=411/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
233 + "type" : "PRODUCT"
234 + },
235 + {
236 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=650,height=650,appearanceId=411,crop=detail,modelId=1111,version=1554884899/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
237 + "type" : "ALTERNATIVE_MODEL"
238 + }
239 + ],
240 + "sellableId" : "74bYwmw5a3tXgyZpnw7j-812-7",
241 + "ideaId" : "5c7e78f95fd3e45786249fb0",
242 + "productTypeId" : "812",
243 + "price" :
244 + {
245 + "amount" : 21.99,
246 + "currencyId" : "1"
247 + },
248 + "name" : "Boss in black",
249 + "description" : "Be your own boss in black and printed by real people in black!",
250 + "tags" :
251 + [
252 + "Fanwear",
253 + "SpreadShop",
254 + "Awesome"
255 + ],
256 + "previewImage" :
257 + {
258 + "url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=500,height=500,appearanceId=1,crop=list,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
259 + "type" : "MODEL"
260 + },
261 + "appearanceIds" :
262 + [
263 + "411",
264 + "645",
265 + "649",
266 + "1",
267 + "366",
268 + "92",
269 + "39",
270 + "231",
271 + "317",
272 + "3",
273 + "29",
274 + "328"
275 + ],
276 + "defaultAppearanceId" : "1"
238 238  }
239 -],
240 -"sellableId" : "74bYwmw5a3tXgyZpnw7j-812-7",
241 -"ideaId" : "5c7e78f95fd3e45786249fb0",
242 -"productTypeId" : "812",
243 -"price" :
244 -{
245 -"amount" : 21.99,
246 -"currencyId" : "1"
247 -},
248 -"name" : "Boss in black",
249 -"description" : "Be your own boss in black and printed by real people in black!",
250 -"tags" :
251 -[
252 -"Fanwear",
253 -"SpreadShop",
254 -"Awesome"
255 -],
256 -"previewImage" :
257 -{
258 -"url" : "https://image.spreadshirtmedia.net/image-server/v1/products/T812A1PA3811PT17X49Y84D142648902FS2951PA3813PT17X60Y17D142648934FS2706/views/1,width=500,height=500,appearanceId=1,crop=list,modelId=85,version=1554885779/be-your-own-boss-in-black-and-printed-by-real-people-in-black.jpg",
259 -"type" : "MODEL"
260 -},
261 -"appearanceIds" :
262 -[
263 -"411",
264 -"645",
265 -"649",
266 -"1",
267 -"366",
268 -"92",
269 -"39",
270 -"231",
271 -"317",
272 -"3",
273 -"29",
274 -"328"
275 -],
276 -"defaultAppearanceId" : "1"
277 -}
278 278  {{/code}}
279 279  
280 280  \\
... ... @@ -308,11 +308,11 @@
308 308  
309 309  {{code language="xml" title="Payload Fragment"}}
310 310  <element id="MLorqlGGrLhljORQ7old-1007-22" type="sprd:sellable">
311 -<properties>
312 -<property key="appearance">539</property>
313 -<property key="size">3</property>
314 -</properties>
315 -<shop id="100229382" href="https://api.spreadshirt.net/api/v1/shops/100229382"/>
311 + <properties>
312 + <property key="appearance">539</property>
313 + <property key="size">3</property>
314 + </properties>
315 + <shop id="100229382" href="https://api.spreadshirt.net/api/v1/shops/100229382"/>
316 316  </element>
317 317  {{/code}}
318 318  
... ... @@ -334,13 +334,17 @@
334 334  
335 335  {{code language="js" title="Response Payload"}}
336 336  {
337 -"ideaId": "5d0a19935fd3e41d7dd6900f",
338 -"productTypeId": "725",
339 -"sellableId": "R43XoE5rBATzxQnRNykG-725-9"
337 + "ideaId": "5d0a19935fd3e41d7dd6900f",
338 + "productTypeId": "725",
339 + "sellableId": "R43XoE5rBATzxQnRNykG-725-9"
340 340  }
341 341  {{/code}}
342 342  
343 -== Code example ==
343 += Implementation Support =
344 344  
345 -There is an example integration of this API available [[here>>url:https://github.com/spreadshirt/shop-api-example-integration||shape="rect"]].
345 +If you do not own a Partner Area based shop yet, but need something "in hand" to develop your implementation, you can rely on the **example shop 100488332** provided by us. The shop is available on the European platform (.net) only. You can use articleId=(% style="color: rgb(80,80,80);" %)999999999 to test the **legacy article mapping resource **in this shop.
346 +
347 +Also, there is an **example integration** of this API available [[here>>url:https://github.com/spreadshirt/shop-api-example-integration||shape="rect"]].
346 346  It shows a draft of a shop system written in php that might be helpful to understand the (list-page -> detail-page -> add-to-basket) workflow.
349 +
350 +\\
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -28278802
1 +28278806
url
... ... @@ -1,1 +1,1 @@
1 -https://developer.spreadshirt.net/wiki/spaces/API/pages/28278802/Public Shop API
1 +https://developer.spreadshirt.net/wiki/spaces/API/pages/28278806/Public Shop API