{"id":5563,"date":"2015-01-27T18:45:48","date_gmt":"2015-01-27T18:45:48","guid":{"rendered":"https:\/\/www.gosquared.com\/blog\/?p=5563"},"modified":"2019-11-28T11:56:14","modified_gmt":"2019-11-28T11:56:14","slug":"api-key-management","status":"publish","type":"post","link":"https:\/\/www.gosquared.com\/blog\/api-key-management","title":{"rendered":"API Key Management"},"content":{"rendered":"<p>Right from the very start, the GoSquared API has been a great way to access all of the data visualised in our Now and Trends dashboards. Now, however, there is even more power in the API &#8211; tracking data, editing account preferences and accessing financial data tracked in Ecommerce Analytics.<\/p>\n<p>Before today, each user would have a single API Key which provides access to all API functions, including the powerful functions mentioned above.<\/p>\n<p>Now, each user can have any number of API Keys, each with individual permissions (scopes) to help lock down API access and prevent applications from accessing, tracking or modifying data when they shouldn&#8217;t. All keys can be managed via the <a href=\"https:\/\/www.gosquared.com\/settings\/api\" target=\"_blank\" rel=\"noopener noreferrer\">API Keys<\/a> page in your account area.<\/p>\n<p>Your old API key will continue to work and have access to all scopes, unless you edit or revoke it.<\/p>\n<h2>Scopes<\/h2>\n<p>The new API scopes are as follows&#8230;<\/p>\n<ul>\n<li><code>read_now<\/code> &#8211; Read real-time data from the <a  target=\"_blank\" href=\"https:\/\/www.gosquared.com\/developer\/api\/now\/v3\/\" rel=\"noopener noreferrer\">Now API<\/a>. Powers the <a href=\"https:\/\/www.gosquared.com\/now\">Now dashboard<\/a>.<\/li>\n<li><code>read_trends<\/code> &#8211; Read historical data from the <a href=\"https:\/\/www.gosquared.com\/developer\/api\/trends\/v2\/\"  target=\"_blank\" rel=\"noopener noreferrer\">Trends API<\/a>. Powers the <a href=\"https:\/\/www.gosquared.com\/trends\">Trends dashboard<\/a>.<\/li>\n<li><code>read_ecommerce<\/code> &#8211; Read historical Ecommerce data from the <a href=\"https:\/\/www.gosquared.com\/developer\/api\/ecommerce\/v1\/\"  target=\"_blank\" rel=\"noopener noreferrer\">Ecommerce API<\/a>. Powers the <a href=\"https:\/\/www.gosquared.com\/ecommerce\">Ecommerce dashboard<\/a>.<\/li>\n<li><code>read_account<\/code> &#8211; Read account related data from the <a href=\"https:\/\/www.gosquared.com\/developer\/api\/account\/v1\/\"  target=\"_blank\" rel=\"noopener noreferrer\">Account API<\/a>.<\/li>\n<li><code>write_account<\/code> &#8211; Write to the <a href=\"https:\/\/www.gosquared.com\/developer\/api\/account\/v1\/\"  target=\"_blank\" rel=\"noopener noreferrer\">Account API<\/a>, such as creating new sites or adding new shared users.<\/li>\n<li><code>write_tracking<\/code> &#8211; Write to the brand new <a href=\"https:\/\/beta.gosquared.com\/docs\/tracking\/\"  target=\"_blank\" rel=\"noopener noreferrer\">Tracking API<\/a>. This enables event tracking and much more from any application.<\/li>\n<\/ul>\n<p>Those familiar with OAuth may see some similarities with the <code>scope<\/code> permissions. In the near future, we hope to add an OAuth style key-generation process which will enable application developers to get access to the API with minimal friction.<\/p>\n<h2>Conclusions<\/h2>\n<p>Just like the <a href=\"https:\/\/engineering.gosquared.com\/deprecation-insecure-http-api\" target=\"_blank\" rel=\"noopener noreferrer\">deprecation of the insecure HTTP API<\/a>, these changes come as part of our continued efforts to maintain a high level of security for our customers and their data.<\/p>\n<p><a href=\"https:\/\/www.gosquared.com\/settings\/api\" target=\"_blank\" rel=\"noopener noreferrer\">View and manage your API Keys<\/a><br \/><a href=\"https:\/\/www.gosquared.com\/join\" target=\"_blank\" rel=\"noopener noreferrer\">Create a GoSquared account now<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Right from the very start, the GoSquared API has been a great way to access all of the data visualised&#8230;<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1452],"tags":[],"class_list":["post-5563","post","type-post","status-publish","format-standard","hentry","category-engineering"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v18.6 (Yoast SEO v19.0) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>API Key Management - GoSquared Blog<\/title>\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.gosquared.com\/blog\/api-key-management\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Key Management\" \/>\n<meta property=\"og:description\" content=\"Right from the very start, the GoSquared API has been a great way to access all of the data visualised...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.gosquared.com\/blog\/api-key-management\" \/>\n<meta property=\"og:site_name\" content=\"GoSquared Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/GoSquared\" \/>\n<meta property=\"article:published_time\" content=\"2015-01-27T18:45:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-11-28T11:56:14+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@simon_tabor\" \/>\n<meta name=\"twitter:site\" content=\"@GoSquared\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Simon Tabor\" \/>\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\":\"Organization\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/#organization\",\"name\":\"GoSquared\",\"url\":\"https:\/\/www.gosquared.com\/blog\/\",\"sameAs\":[\"https:\/\/instagram.com\/gosquaredteam\",\"https:\/\/www.linkedin.com\/company\/go-squared-ltd.\",\"https:\/\/www.facebook.com\/GoSquared\",\"https:\/\/twitter.com\/GoSquared\"],\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.gosquared.com\/blog\/wp-content\/uploads\/2015\/07\/gosquared.png\",\"contentUrl\":\"https:\/\/www.gosquared.com\/blog\/wp-content\/uploads\/2015\/07\/gosquared.png\",\"width\":1270,\"height\":250,\"caption\":\"GoSquared\"},\"image\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/#website\",\"url\":\"https:\/\/www.gosquared.com\/blog\/\",\"name\":\"GoSquared Blog\",\"description\":\"Turn visitors into customers.\",\"publisher\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.gosquared.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage\",\"url\":\"https:\/\/www.gosquared.com\/blog\/api-key-management\",\"name\":\"API Key Management - GoSquared Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/#website\"},\"datePublished\":\"2015-01-27T18:45:48+00:00\",\"dateModified\":\"2019-11-28T11:56:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.gosquared.com\/blog\/api-key-management\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.gosquared.com\/blog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Key Management\"}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage\"},\"author\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/71fad71f60ad33cf9356687b37aed3d0\"},\"headline\":\"API Key Management\",\"datePublished\":\"2015-01-27T18:45:48+00:00\",\"dateModified\":\"2019-11-28T11:56:14+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage\"},\"wordCount\":311,\"publisher\":{\"@id\":\"https:\/\/www.gosquared.com\/blog\/#organization\"},\"articleSection\":[\"Engineering\"],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/71fad71f60ad33cf9356687b37aed3d0\",\"name\":\"Simon Tabor\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/dc920e48608646bda51d2e6e2595e8ad926cff52eba534c1d25fb1618f15b59f?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/dc920e48608646bda51d2e6e2595e8ad926cff52eba534c1d25fb1618f15b59f?s=96&d=mm&r=g\",\"caption\":\"Simon Tabor\"},\"description\":\"Lead developer at GoSquared for integrations, partnerships and the API. Works on pretty much everything.\",\"sameAs\":[\"http:\/\/simontabor.com\",\"https:\/\/twitter.com\/simon_tabor\"],\"url\":\"https:\/\/www.gosquared.com\/blog\/author\/simontabor\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"API Key Management - GoSquared Blog","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.gosquared.com\/blog\/api-key-management","og_locale":"en_US","og_type":"article","og_title":"API Key Management","og_description":"Right from the very start, the GoSquared API has been a great way to access all of the data visualised...","og_url":"https:\/\/www.gosquared.com\/blog\/api-key-management","og_site_name":"GoSquared Blog","article_publisher":"https:\/\/www.facebook.com\/GoSquared","article_published_time":"2015-01-27T18:45:48+00:00","article_modified_time":"2019-11-28T11:56:14+00:00","twitter_card":"summary_large_image","twitter_creator":"@simon_tabor","twitter_site":"@GoSquared","twitter_misc":{"Written by":"Simon Tabor","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Organization","@id":"https:\/\/www.gosquared.com\/blog\/#organization","name":"GoSquared","url":"https:\/\/www.gosquared.com\/blog\/","sameAs":["https:\/\/instagram.com\/gosquaredteam","https:\/\/www.linkedin.com\/company\/go-squared-ltd.","https:\/\/www.facebook.com\/GoSquared","https:\/\/twitter.com\/GoSquared"],"logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.gosquared.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.gosquared.com\/blog\/wp-content\/uploads\/2015\/07\/gosquared.png","contentUrl":"https:\/\/www.gosquared.com\/blog\/wp-content\/uploads\/2015\/07\/gosquared.png","width":1270,"height":250,"caption":"GoSquared"},"image":{"@id":"https:\/\/www.gosquared.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"WebSite","@id":"https:\/\/www.gosquared.com\/blog\/#website","url":"https:\/\/www.gosquared.com\/blog\/","name":"GoSquared Blog","description":"Turn visitors into customers.","publisher":{"@id":"https:\/\/www.gosquared.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.gosquared.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage","url":"https:\/\/www.gosquared.com\/blog\/api-key-management","name":"API Key Management - GoSquared Blog","isPartOf":{"@id":"https:\/\/www.gosquared.com\/blog\/#website"},"datePublished":"2015-01-27T18:45:48+00:00","dateModified":"2019-11-28T11:56:14+00:00","breadcrumb":{"@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.gosquared.com\/blog\/api-key-management"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.gosquared.com\/blog"},{"@type":"ListItem","position":2,"name":"API Key Management"}]},{"@type":"Article","@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#article","isPartOf":{"@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage"},"author":{"@id":"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/71fad71f60ad33cf9356687b37aed3d0"},"headline":"API Key Management","datePublished":"2015-01-27T18:45:48+00:00","dateModified":"2019-11-28T11:56:14+00:00","mainEntityOfPage":{"@id":"https:\/\/www.gosquared.com\/blog\/api-key-management#webpage"},"wordCount":311,"publisher":{"@id":"https:\/\/www.gosquared.com\/blog\/#organization"},"articleSection":["Engineering"],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/71fad71f60ad33cf9356687b37aed3d0","name":"Simon Tabor","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.gosquared.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/dc920e48608646bda51d2e6e2595e8ad926cff52eba534c1d25fb1618f15b59f?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/dc920e48608646bda51d2e6e2595e8ad926cff52eba534c1d25fb1618f15b59f?s=96&d=mm&r=g","caption":"Simon Tabor"},"description":"Lead developer at GoSquared for integrations, partnerships and the API. Works on pretty much everything.","sameAs":["http:\/\/simontabor.com","https:\/\/twitter.com\/simon_tabor"],"url":"https:\/\/www.gosquared.com\/blog\/author\/simontabor"}]}},"wps_subtitle":"Improved Security in the GoSquared API","_links":{"self":[{"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/posts\/5563","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/comments?post=5563"}],"version-history":[{"count":0,"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/posts\/5563\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/media?parent=5563"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/categories?post=5563"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gosquared.com\/blog\/wp-json\/wp\/v2\/tags?post=5563"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}