Changes for page Spreadshirt Public Shop API Documentation
Last modified by admin on 2023/02/14 14:43
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Objects (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - Home1 +Spreadshirt Public Shop API Documentation - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. jns1 +XWiki.shop - Content
-
... ... @@ -1,23 +1,69 @@ 1 -(% class="auto-cursor-target" %) 2 -\\ 1 += Preface = 3 3 4 -{{info}} 5 -<p>Please note that we are currently updating our API documentation. We are sorry if this should lead to some inconsistencies in our documentation during that time.</p> 6 -{{/info}} 3 +Spreadshirt provides several ways to offer an online shop experience to your customers and earn money through commission: 7 7 5 +1. The standalone Spreadshop ([[this>>url:https://shop.spreadshirt.com/SpreadShop||rel="nofollow" shape="rect" class="external-link"]], for example). This application is officially developed, hosted and maintained by Spreadshirt. Running a Spreadshop requires zero technical skills and is always the recommended approach. 6 +1. JavaScript integration (described [[here>>url:https://help.spreadshop.com/hc/en-us/articles/360010529039-Website-Integration-with-JavaScript||shape="rect"]]). If you have an existing website, you can embed a piece of JavaScript into it that manipulates your website in order to embed the Spreadshop into your site. This requires a decent understanding of HTML and CSS in order to resolve any conflicts between your site and the Spreadshop that may arise. 7 +1. CMS plugins for [[WordPress>>url:https://wordpress.org/plugins/spreadshop/#developers||rel="nofollow" shape="rect" class="external-link"]] and others (currently just [[Joomla>>url:https://extensions.joomla.org/extension/spreadshop/||rel="nofollow" shape="rect" class="external-link"]]) that embed the JavaScript snippet mentioned in (2.) for you. If you run a website based on such CMS, these plugins can make your life a bit easier. An understanding of HTML and CSS is nonetheless important. 8 +1. An independent, custom built web application based on the **Public Shop API** described in this document. This interface is for web developers only (or people who can afford to hire one). Going for this approach is only feasible for people who have a solid understanding of server side & client side programming, HTTP, HTML and CSS. 9 + 10 += Prerequisites = 11 + 12 +Spreadshirt runs a European and a North American platform that are independent from another. You need to: 13 + 14 +* Choose a platform 15 +* Register a Spreadshop: 16 +** Europe: [[here>>url:https://www.spreadshirt.net/start-selling-C5780||shape="rect"]] 17 +** North America: [[here>>url:https://www.spreadshirt.com/start-selling-shirts-C3598||shape="rect"]] 18 +* Log into the partner area using exactly one of the following links: 19 +** Europe: [[here>>url:https://partner.spreadshirt.net||shape="rect"]] 20 +** North America: [[here>>url:https://partner.spreadshirt.com||shape="rect"]] 21 +* In the same browser session, visit one of the following pages to retrieve your API Key. This will only work if you are already logged in as described above. 22 +** Europe: [[here>>url:https://www.spreadshirt.net/userarea/-C7120||shape="rect"]] 23 +** North America: [[here>>url:https://www.spreadshirt.com/userarea/-C6840||shape="rect"]] 24 + 25 += Basics = 26 + 27 +* The API described here is loosely based on [[REST>>url:https://en.wikipedia.org/wiki/Representational_state_transfer||shape="rect"]] principles. This means among other things that all endpoints can be accessed via HTTPS and HTTP clients like [[curl>>url:https://curl.haxx.se/||shape="rect"]] or [[postman>>url:https://www.getpostman.com/||shape="rect"]] can be used directly to explore the API. 28 +* The base url for all requests is [[https:~~/~~/api.spreadshirt.net>>url:https://api.spreadshirt.net||shape="rect"]] for eu or [[https:~~/~~/api.spreadshirt.com>>url:https://api.spreadshirt.com||shape="rect"]] for na. (This only applies to REST resources, images are retrieved from [[https:~~/~~/image.spreadshirtmedia.net>>url:https://image.spreadshirtmedia.net||shape="rect"]] or [[https:~~/~~/image.spreadshirtmedia.com>>url:https://image.spreadshirtmedia.com||shape="rect"]].) 29 +* ((( 8 8 (% class="auto-cursor-target" %) 9 - \\31 +All requests have to be made with HTTP headers "Authorization" and "User-Agent". The authorization header must include your API key and the user agent header must include the name of your application, then its version, followed by a domain and a contact email address: 10 10 11 -{{info title="Coming soon - new Public Shop API"}} 12 -<p>As announced at <span class="wikiexternallink"><a shape="rect" href="https://www.spreadshirt.net/forum/t/what-to-do-if-im-still-in-the-legacy-user-area-and-using-spreadshirts-api-or-a-third-party-plugin/6124">https://www.spreadshirt.net/forum/t/what-to-do-if-im-still-in-the-legacy-user-area-and-using-spreadshirts-api-or-a-third-party-plugin/6124</a></span> our new <strong>Public Shop API<span class="wikicreatelink"><a href="/bin/create/Confluence/Migrator/Public%20Shop%20API?parent=Confluence.Migrator.WebHome"> </a></span></strong>documentation will be available soon!</p> 13 -{{/info}} 33 +|=((( 34 +Header Key 35 +)))|=((( 36 +Header Value Format 37 +)))|=((( 38 +Example Header Value 39 +))) 40 +|((( 41 +Authorization 42 +)))|((( 43 +SprdAuth apiKey="<apikey>" 44 +)))|((( 45 +SprdAuth apiKey="dd30b4db-8cd6-4fb8-86b3-e680984b9e18" 46 +))) 47 +|((( 48 +User-Agent 49 +)))|((( 50 +<YourApplication>/<YourApplicationVersion> ([[https:~~/~~/www.yourdomain.com>>url:https://www.yourdomain.com/||shape="rect"]]; [[yourname@yourdomain.com>>mailto:yourname@yourdomain.com||shape="rect"]]) 51 +)))|((( 52 +WordPress-Plugin/1.0 ([[https:~~/~~/www.deinblog.com>>url:https://www.deinblog.com/||shape="rect"]]; [[admin@deinblog.com>>mailto:admin@deinblog.com||shape="rect"]]) 53 +))) 14 14 15 15 (% class="auto-cursor-target" %) 16 -\\ 56 +Failing to provide this information may result in your requests getting blocked at any point in time because traffic of unknown source can be considered illegitimate. 57 +))) 58 +* All requests should be performed with a ?mediaType=json query parameter to get the responses in the recommended JSON format. Leaving the parameter out may or may not result in a response in XML format which is harder to work with. 59 +* All REST resources return HTTP status code 200 or 201 in case of successful requests. Status codes from the 4xx range indicate a mistake on your side while errors from the 5xx range indicate an error on ours. 60 +* Timestamps are returned in ISO8601 format. 17 17 18 -{{section}} 19 -<p class="auto-cursor-target"><br/></p><p class="auto-cursor-target"><br/></p><p class="auto-cursor-target"><br/></p><p class="auto-cursor-target"><br/></p> 20 -{{/section}} 62 += Next Steps = 21 21 64 +There is a [[tutorial>>doc:Build your own shop system]] available showing the use of this API in order to **implement an own shop system**. 65 + 66 += [[doc:Legal Information]] = 67 + 22 22 (% class="auto-cursor-target" %) 23 23 \\
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 -2 82788091 +56230020 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://developer.spreadshirt.net/wiki/spaces/API/pages/2 8278809/Home1 +https://developer.spreadshirt.net/wiki/spaces/API/pages/56230020/Spreadshirt Public Shop API Documentation