{"id":17020,"date":"2018-02-08T04:42:36","date_gmt":"2018-02-08T08:42:36","guid":{"rendered":"https:\/\/www.spreadshop.com\/blog\/?p=17020"},"modified":"2025-04-29T10:35:30","modified_gmt":"2025-04-29T14:35:30","slug":"changes-api-usage-implemention","status":"publish","type":"post","link":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/","title":{"rendered":"Changes in API Usage \u2013 Implemention"},"content":{"rendered":"<p class=\"\" data-start=\"179\" data-end=\"494\">Starting <strong data-start=\"188\" data-end=\"203\">February 12<\/strong>, access to our API will require <strong data-start=\"236\" data-end=\"258\">three key elements<\/strong>: a valid <strong data-start=\"268\" data-end=\"279\">API key<\/strong>, a properly set <strong data-start=\"296\" data-end=\"310\">user agent<\/strong>, and secure communication via <strong data-start=\"341\" data-end=\"350\">HTTPS<\/strong>. This change was first announced in December to give developers ample time to make adjustments, and we\u2019re now approaching the enforcement date.<\/p>\n<p class=\"\" data-start=\"496\" data-end=\"690\">To check whether your current API client setup is compatible, you can test it by including the <code data-start=\"591\" data-end=\"607\">X-Api-Key-Test<\/code> header in your requests. This helps ensure a smooth transition before February 12.<\/p>\n<ul data-start=\"692\" data-end=\"897\">\n<li class=\"\" data-start=\"692\" data-end=\"787\">\n<p class=\"\" data-start=\"694\" data-end=\"787\"><strong data-start=\"694\" data-end=\"724\">Without header (insecure):<\/strong><br data-start=\"724\" data-end=\"727\" \/><code data-start=\"729\" data-end=\"787\">curl -v 'http:\/\/api.spreadshirt.net\/api\/v1\/shops\/205909'<\/code><\/p>\n<\/li>\n<li class=\"\" data-start=\"789\" data-end=\"897\">\n<p class=\"\" data-start=\"791\" data-end=\"897\"><strong data-start=\"791\" data-end=\"812\">With test header:<\/strong><br data-start=\"812\" data-end=\"815\" \/><code data-start=\"817\" data-end=\"897\">curl -H 'X-Api-Key-Test: yes' 'http:\/\/api.spreadshirt.net\/api\/v1\/shops\/205909'<\/code><\/p>\n<\/li>\n<\/ul>\n<h3 class=\"\" data-start=\"899\" data-end=\"923\">What You Need to Do:<\/h3>\n<ul data-start=\"924\" data-end=\"1188\">\n<li class=\"\" data-start=\"924\" data-end=\"1003\">\n<p class=\"\" data-start=\"926\" data-end=\"1003\"><strong data-start=\"926\" data-end=\"939\">Use HTTPS<\/strong> for all API requests to ensure your data is securely encrypted.<\/p>\n<\/li>\n<li class=\"\" data-start=\"1004\" data-end=\"1089\">\n<p class=\"\" data-start=\"1006\" data-end=\"1089\"><strong data-start=\"1006\" data-end=\"1037\">Include a user agent header<\/strong> that clearly identifies your domain or application.<\/p>\n<\/li>\n<li class=\"\" data-start=\"1090\" data-end=\"1188\">\n<p class=\"\" data-start=\"1092\" data-end=\"1188\"><strong data-start=\"1092\" data-end=\"1115\">Attach your API key<\/strong>, preferably via the <code data-start=\"1136\" data-end=\"1151\">Authorization<\/code> header, so it is also sent securely.<\/p>\n<\/li>\n<\/ul>\n<h3 class=\"\" data-start=\"208\" data-end=\"236\">Why These Changes Matter<\/h3>\n<p class=\"\" data-start=\"238\" data-end=\"357\"><span class=\"relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out\">The shift to requiring HTTPS, valid API keys, and user-agent headers isn&#8217;t just a technical formality. It&#8217;s a crucial step toward enhancing the security and reliability of our platform!<\/span><\/p>\n<p class=\"\" data-start=\"238\" data-end=\"357\"><span class=\"relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out\">By enforcing encrypted connections through HTTPS, we ensure that data exchanged between your applications and our API remains confidential and protected.<\/span>\u200b<\/p>\n<p class=\"\" data-start=\"359\" data-end=\"478\"><span class=\"relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out\">Implementing API keys allows us to authenticate and authorize each request, ensuring that only approved applications can access specific resources.<\/span> <span class=\"relative -mx-px my-[-0.2rem] rounded px-px py-[0.2rem] transition-colors duration-100 ease-in-out\">This not only safeguards our system against unauthorized usage but also helps in monitoring and managing API traffic effectively.<\/span>\u200b<\/p>\n<p class=\"\" data-start=\"1190\" data-end=\"1379\">If you\u2019re unsure how to implement the required headers or switch to HTTPS, our <a class=\"\" href=\"https:\/\/www.spreadshop.com\/helpcenter\/\" target=\"_new\" rel=\"noopener\" data-start=\"383\" data-end=\"436\">Help Center<\/a> has detailed documentation and examples to guide you.<\/p>\n<p data-start=\"1190\" data-end=\"1379\">Set up your API implementation and make these needed adjusts as soon as possible for safety purposes.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As of 12 February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.  <a href=\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\">Read more<\/a><\/p>\n","protected":false},"author":674,"featured_media":16764,"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":[18625],"tags":[30575],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.3 (Yoast SEO v19.7.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Changes in API Usage \u2013 Implemention - The Spreadshop Blog<\/title>\n<meta name=\"description\" content=\"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.\" \/>\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\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Changes in API Usage \u2013 Implemention\" \/>\n<meta property=\"og:description\" content=\"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\" \/>\n<meta property=\"og:site_name\" content=\"The Spreadshop Blog\" \/>\n<meta property=\"article:published_time\" content=\"2018-02-08T08:42:36+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-04-29T14:35:30+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=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Lena\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\",\"url\":\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\",\"name\":\"Changes in API Usage \u2013 Implemention - The Spreadshop Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.spreadshop.com\/blog\/#website\"},\"datePublished\":\"2018-02-08T08:42:36+00:00\",\"dateModified\":\"2025-04-29T14:35:30+00:00\",\"author\":{\"@id\":\"https:\/\/www.spreadshop.com\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176\"},\"description\":\"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.spreadshop.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Changes in API Usage \u2013 Implemention\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.spreadshop.com\/blog\/#website\",\"url\":\"https:\/\/www.spreadshop.com\/blog\/\",\"name\":\"The Spreadshop Blog\",\"description\":\"Spreadshop Blog\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.spreadshop.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.spreadshop.com\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176\",\"name\":\"Lena\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.spreadshop.com\/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\/blog\/author\/Lena Reth\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Changes in API Usage \u2013 Implemention - The Spreadshop Blog","description":"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.","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\/blog\/2018\/02\/08\/changes-api-usage-implemention\/","og_locale":"en_US","og_type":"article","og_title":"Changes in API Usage \u2013 Implemention","og_description":"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.","og_url":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/","og_site_name":"The Spreadshop Blog","article_published_time":"2018-02-08T08:42:36+00:00","article_modified_time":"2025-04-29T14:35:30+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":{"Written by":"Lena","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/","url":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/","name":"Changes in API Usage \u2013 Implemention - The Spreadshop Blog","isPartOf":{"@id":"https:\/\/www.spreadshop.com\/blog\/#website"},"datePublished":"2018-02-08T08:42:36+00:00","dateModified":"2025-04-29T14:35:30+00:00","author":{"@id":"https:\/\/www.spreadshop.com\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176"},"description":"As of February, you\u2019ll only be able to access our API with a valid API key and user agent via HTTPS. We announced this in December.","breadcrumb":{"@id":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.spreadshop.com\/blog\/2018\/02\/08\/changes-api-usage-implemention\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.spreadshop.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Changes in API Usage \u2013 Implemention"}]},{"@type":"WebSite","@id":"https:\/\/www.spreadshop.com\/blog\/#website","url":"https:\/\/www.spreadshop.com\/blog\/","name":"The Spreadshop Blog","description":"Spreadshop Blog","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.spreadshop.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.spreadshop.com\/blog\/#\/schema\/person\/678cee42723a944607e63a9022f5f176","name":"Lena","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.spreadshop.com\/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\/blog\/author\/Lena Reth\/"}]}},"_links":{"self":[{"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/posts\/17020"}],"collection":[{"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/users\/674"}],"replies":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/comments?post=17020"}],"version-history":[{"count":4,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/posts\/17020\/revisions"}],"predecessor-version":[{"id":29039,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/posts\/17020\/revisions\/29039"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/media\/16764"}],"wp:attachment":[{"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/media?parent=17020"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/categories?post=17020"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.spreadshop.com\/blog\/wp-json\/wp\/v2\/tags?post=17020"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}