{"id":33223,"date":"2017-12-21T14:48:23","date_gmt":"2017-12-21T12:48:23","guid":{"rendered":"https:\/\/www.spreadshop.com\/de\/blog\/?p=33223"},"modified":"2025-08-07T15:26:01","modified_gmt":"2025-08-07T13:26:01","slug":"aenderung-der-api-benutzung","status":"publish","type":"post","link":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/","title":{"rendered":"\u00c4nderung der API-Benutzung"},"content":{"rendered":"<p>F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Die Details erf\u00e4hrst Du in diesem Blogpost.<\/p>\n<p><!--more--><\/p>\n<p>Fangen wir mit einer kurzen Zusammenfassung an: Ab Anfang 2018 m\u00fcssen alle Applikationen, die unsere API verwenden \u2026<\/p>\n<ul>\n<li>\u2026 \u00fcber HTTPS durchgef\u00fchrt werden,<\/li>\n<li>\u2026 die offiziellen Domains api.spreadshirt.com (NA-Plattform) und api.spreadshirt.net (EU-Plattform) verwenden.<\/li>\n<li>\u2026 einen g\u00fcltigen API-Key mitschicken und<\/li>\n<li>\u2026 einen User-Agent bereitstellen.<\/li>\n<\/ul>\n<h2>HTTPS<\/h2>\n<p>Sicher ist sicher: Alle Anfragen an unsere API m\u00fcssen in Zukunft \u00fcber HTTPS durchgef\u00fchrt werden. Anfragen, die \u00fcber HTTP durchgef\u00fchrt werden, werden demn\u00e4chst einfach auf HTTPS redirected.<\/p>\n<h2>Offizielle Domains<\/h2>\n<p>Wir machen es offiziell: Alle Anfragen m\u00fcssen in Zukunft \u00fcber unsere offiziellen Domains api.spreadshirt.net und api.spreadshirt.com durchgef\u00fchrt werden. Andere Routen f\u00fcr die API-Benutzung werden dann geschlossen. Aus Sicherheitsgr\u00fcnden behalten wir uns auch vor, den Zugriff \u00fcber inoffizielle Routen zu blocken.<\/p>\n<h2>API-Key<\/h2>\n<p>Alle Applikationen, die Anfragen an unsere API stellen, m\u00fcssen einen g\u00fcltigen API-Key mitschicken.\u00a0Am einfachsten geht das, indem man an jede URL einen Query-Parameter mit dem API-Key anh\u00e4ngt wie zum Beispiel:<\/p>\n<p>https:\/\/api.spreadshirt.net\/api\/v1\/shops\/205909?apiKey=8e5bb312-9060-446f-ada2-8c319327745a<\/p>\n<p>Diese Variante werden wir zwar weiter unterst\u00fctzen, empfehlen sie aber nicht mehr.<\/p>\n<p>Besser ist es, den daf\u00fcr vorgesehenen Authorization-Header zu verwenden, <a href=\"https:\/\/developer.spreadshirt.net\/display\/API\/Security\">wie zum Beispiel<\/a>:<\/p>\n<ul>\n<li>https:\/\/api.spreadshirt.net\/api\/v1\/shops\/205909<\/li>\n<li>Authorization: SprdAuth apiKey=&#8221;8e5bb312-9060-446f-ada2-8c319327745a&#8221;<\/li>\n<\/ul>\n<p>Bei der Kommunikation \u00fcber HTTPS wird der Header dann ebenfalls verschl\u00fcsselt \u00fcbertragen.<\/p>\n<p>API-Keys f\u00fcr unsere EU- und NA-Plattform kann man hier bekommen:<\/p>\n<ul>\n<li>https:\/\/www.spreadshirt.de\/-C7120<\/li>\n<li>https:\/\/www.spreadshirt.com\/-C6840<\/li>\n<\/ul>\n<h2>User-Agent<\/h2>\n<p>Alle Applikationen, die nicht in einem Browser laufen, m\u00fcssen in Zukunft zus\u00e4tzlich einen g\u00fcltigen User-Agent mitschicken, der es erlaubt, den API-Benutzer zu identifizieren. Der User-Agent muss wie folgt aussehen:<\/p>\n<p>User-Agent: &lt;DeineAnwendung&gt;\/&lt;DeineAnwendungsversion&gt; (https:\/\/www.deinedomain.com; deinname@deinedomain.com)<\/p>\n<p>Beispielhaft sieht ein User-Agent so aus:<\/p>\n<p>User-Agent: WordPress-Plugin\/1.0 (https:\/\/www.deinblog.com; admin@deinblog.com)<\/p>\n<p>Wenn ihr unser API verwendet, stellt bitte neben dem Anwendungsnamen und der Version auch die Domain und die E-Mail-Adresse des Administrators bereit. Damit wir im Notfall auch eine Chance haben, Kontakt aufzunehmen.<\/p>\n<p>Wir hoffen, dass ihr mit den \u00c4nderungen genauso zufrieden seid, wie wir. Falls ihr noch Fragen oder Anregungen habt, dann sind wir nat\u00fcrlich f\u00fcr euch da.<\/p>\n<div class=\"shariff shariff-align-flex-start shariff-widget-align-flex-start\">\n<div class=\"ShariffHeadline\">\n<h3 class=\"shariff_headline\">Teile diesen Beitrag<\/h3>\n<\/div>\n<ul class=\"shariff-buttons theme-default orientation-horizontal buttonsize-small\">\n<li class=\"shariff-button facebook shariff-nocustomcolor\" style=\"background-color:#4273c8\"><a href=\"https:\/\/www.facebook.com\/sharer\/sharer.php?u=https%3A%2F%2Fwww.spreadshop.com%2Fblog%2Fde%2F2017%2F12%2F21%2Faenderung-der-api-benutzung%2F\" title=\"Bei Facebook teilen\" aria-label=\"Bei Facebook teilen\" role=\"button\" rel=\"nofollow\" class=\"shariff-link\" style=\"; background-color:#3b5998; color:#fff\" target=\"_blank\"><span class=\"shariff-icon\" style=\"\"><svg width=\"32px\" height=\"20px\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 18 32\"><path fill=\"#3b5998\" d=\"M17.1 0.2v4.7h-2.8q-1.5 0-2.1 0.6t-0.5 1.9v3.4h5.2l-0.7 5.3h-4.5v13.6h-5.5v-13.6h-4.5v-5.3h4.5v-3.9q0-3.3 1.9-5.2t5-1.8q2.6 0 4.1 0.2z\"><\/path><\/svg><\/span><span class=\"shariff-text\">teilen<\/span>&nbsp;<\/a><\/li>\n<li class=\"shariff-button twitter shariff-nocustomcolor\" style=\"background-color:#595959\"><a href=\"https:\/\/twitter.com\/share?url=https%3A%2F%2Fwww.spreadshop.com%2Fblog%2Fde%2F2017%2F12%2F21%2Faenderung-der-api-benutzung%2F&text=%C3%84nderung%20der%20API-Benutzung\" title=\"Bei X teilen\" aria-label=\"Bei X teilen\" role=\"button\" rel=\"noopener nofollow\" class=\"shariff-link\" style=\"; background-color:#000; color:#fff\" target=\"_blank\"><span class=\"shariff-icon\" style=\"\"><svg width=\"32px\" height=\"20px\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 24 24\"><path fill=\"#000\" d=\"M14.258 10.152L23.176 0h-2.113l-7.747 8.813L7.133 0H0l9.352 13.328L0 23.973h2.113l8.176-9.309 6.531 9.309h7.133zm-2.895 3.293l-.949-1.328L2.875 1.56h3.246l6.086 8.523.945 1.328 7.91 11.078h-3.246zm0 0\"><\/path><\/svg><\/span><span class=\"shariff-text\">teilen<\/span>&nbsp;<\/a><\/li>\n<li class=\"shariff-button pinterest shariff-nocustomcolor\" style=\"background-color:#e70f18\"><a href=\"https:\/\/www.pinterest.com\/pin\/create\/link\/?url=https%3A%2F%2Fwww.spreadshop.com%2Fblog%2Fde%2F2017%2F12%2F21%2Faenderung-der-api-benutzung%2F&media=https%3A%2F%2Fwww.spreadshop.com%2Fblog%2Fde%2Ffiles%2F2021%2F06%2FMDS-637-BP-API-changes-4.png&description=%C3%84nderung%20der%20API-Benutzung\" title=\"Bei Pinterest pinnen\" aria-label=\"Bei Pinterest pinnen\" role=\"button\" rel=\"noopener nofollow\" class=\"shariff-link\" style=\"; background-color:#cb2027; color:#fff\" target=\"_blank\"><span class=\"shariff-icon\" style=\"\"><svg width=\"32px\" height=\"20px\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 27 32\"><path fill=\"#cb2027\" d=\"M27.4 16q0 3.7-1.8 6.9t-5 5-6.9 1.9q-2 0-3.9-0.6 1.1-1.7 1.4-2.9 0.2-0.6 1-3.8 0.4 0.7 1.3 1.2t2 0.5q2.1 0 3.8-1.2t2.7-3.4 0.9-4.8q0-2-1.1-3.8t-3.1-2.9-4.5-1.2q-1.9 0-3.5 0.5t-2.8 1.4-2 2-1.2 2.3-0.4 2.4q0 1.9 0.7 3.3t2.1 2q0.5 0.2 0.7-0.4 0-0.1 0.1-0.5t0.2-0.5q0.1-0.4-0.2-0.8-0.9-1.1-0.9-2.7 0-2.7 1.9-4.6t4.9-2q2.7 0 4.2 1.5t1.5 3.8q0 3-1.2 5.2t-3.1 2.1q-1.1 0-1.7-0.8t-0.4-1.9q0.1-0.6 0.5-1.7t0.5-1.8 0.2-1.4q0-0.9-0.5-1.5t-1.4-0.6q-1.1 0-1.9 1t-0.8 2.6q0 1.3 0.4 2.2l-1.8 7.5q-0.3 1.2-0.2 3.2-3.7-1.6-6-5t-2.3-7.6q0-3.7 1.9-6.9t5-5 6.9-1.9 6.9 1.9 5 5 1.8 6.9z\"><\/path><\/svg><\/span><span class=\"shariff-text\">merken<\/span>&nbsp;<\/a><\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Die Details erf\u00e4hrst Du in diesem Blogpost. <a href=\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\">Weiterlesen<\/a><\/p>\n","protected":false},"author":674,"featured_media":33282,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"image","meta":{"publish_to_discourse":"0","publish_post_category":"","wpdc_auto_publish_overridden":"","wpdc_topic_tags":"","wpdc_pin_topic":"","wpdc_pin_until":"","discourse_post_id":"","discourse_permalink":"","wpdc_publishing_response":"","wpdc_publishing_error":"","_cloudinary_featured_overwrite":false},"categories":[2381],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v19.7.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>\u00c4nderung der API-Benutzung | Das Spreadshop Blog<\/title>\n<meta name=\"description\" content=\"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\" \/>\n<meta property=\"og:locale\" content=\"de_DE\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"\u00c4nderung der API-Benutzung | Das Spreadshop Blog\" \/>\n<meta property=\"og:description\" content=\"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\" \/>\n<meta property=\"og:site_name\" content=\"Das Spreadshop Blog\" \/>\n<meta property=\"article:published_time\" content=\"2017-12-21T12:48:23+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-07T13:26:01+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/images.spreadshop.com\/images\/f_auto,q_auto\/v1513860471\/blog\/Article\/General\/MDS-637-BP-API-changes\/MDS-637-BP-API-changes.png?_i=AA\" \/>\n\t<meta property=\"og:image:width\" content=\"1400\" \/>\n\t<meta property=\"og:image:height\" content=\"800\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Lena\" \/>\n<meta name=\"twitter:label1\" content=\"Verfasst von\" \/>\n\t<meta name=\"twitter:data1\" content=\"Lena\" \/>\n\t<meta name=\"twitter:label2\" content=\"Gesch\u00e4tzte Lesezeit\" \/>\n\t<meta name=\"twitter:data2\" content=\"2\u00a0Minuten\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\",\"url\":\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\",\"name\":\"\u00c4nderung der API-Benutzung | Das Spreadshop Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/#website\"},\"datePublished\":\"2017-12-21T12:48:23+00:00\",\"dateModified\":\"2025-08-07T13:26:01+00:00\",\"author\":{\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176\"},\"description\":\"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/#breadcrumb\"},\"inLanguage\":\"de\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.spreadshop.com\/de\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"\u00c4nderung der API-Benutzung\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/#website\",\"url\":\"https:\/\/www.spreadshop.com\/de\/blog\/\",\"name\":\"Das Spreadshop Blog\",\"description\":\"Alles was Du \u00fcber Spreadshop wissen musst\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.spreadshop.com\/de\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"de\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176\",\"name\":\"Lena\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"de\",\"@id\":\"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/71eefd0047a3453eaab1f9820b27a885?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/71eefd0047a3453eaab1f9820b27a885?s=96&d=mm&r=g\",\"caption\":\"Lena\"},\"description\":\"Community Manager\",\"url\":\"https:\/\/www.spreadshop.com\/de\/blog\/author\/Lena Reth\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\u00c4nderung der API-Benutzung | Das Spreadshop Blog","description":"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/","og_locale":"de_DE","og_type":"article","og_title":"\u00c4nderung der API-Benutzung | Das Spreadshop Blog","og_description":"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.","og_url":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/","og_site_name":"Das Spreadshop Blog","article_published_time":"2017-12-21T12:48:23+00:00","article_modified_time":"2025-08-07T13:26:01+00:00","og_image":[{"width":1400,"height":800,"url":"https:\/\/images.spreadshop.com\/images\/f_auto,q_auto\/v1513860471\/blog\/Article\/General\/MDS-637-BP-API-changes\/MDS-637-BP-API-changes.png?_i=AA","type":"image\/png"}],"author":"Lena","twitter_misc":{"Verfasst von":"Lena","Gesch\u00e4tzte Lesezeit":"2\u00a0Minuten"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/","url":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/","name":"\u00c4nderung der API-Benutzung | Das Spreadshop Blog","isPartOf":{"@id":"https:\/\/www.spreadshop.com\/de\/blog\/#website"},"datePublished":"2017-12-21T12:48:23+00:00","dateModified":"2025-08-07T13:26:01+00:00","author":{"@id":"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176"},"description":"F\u00fcr all diejenigen, die unsere Public API benutzen, gibt es ab Anfang 2018 ein paar wichtige \u00c4nderungen. Details erf\u00e4hrst in Blogpost.","breadcrumb":{"@id":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/#breadcrumb"},"inLanguage":"de","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.spreadshop.com\/de\/blog\/2017\/12\/21\/aenderung-der-api-benutzung\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.spreadshop.com\/de\/blog\/"},{"@type":"ListItem","position":2,"name":"\u00c4nderung der API-Benutzung"}]},{"@type":"WebSite","@id":"https:\/\/www.spreadshop.com\/de\/blog\/#website","url":"https:\/\/www.spreadshop.com\/de\/blog\/","name":"Das Spreadshop Blog","description":"Alles was Du \u00fcber Spreadshop wissen musst","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.spreadshop.com\/de\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"de"},{"@type":"Person","@id":"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176","name":"Lena","image":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/www.spreadshop.com\/de\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/71eefd0047a3453eaab1f9820b27a885?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/71eefd0047a3453eaab1f9820b27a885?s=96&d=mm&r=g","caption":"Lena"},"description":"Community Manager","url":"https:\/\/www.spreadshop.com\/de\/blog\/author\/Lena Reth\/"}]}},"_links":{"self":[{"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/posts\/33223"}],"collection":[{"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/users\/674"}],"replies":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/comments?post=33223"}],"version-history":[{"count":3,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/posts\/33223\/revisions"}],"predecessor-version":[{"id":44485,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/posts\/33223\/revisions\/44485"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/media\/33282"}],"wp:attachment":[{"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/media?parent=33223"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/categories?post=33223"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.spreadshop.com\/de\/blog\/wp-json\/wp\/v2\/tags?post=33223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}