{"_id":"56acdb1c13ac890d001c3c83","user":"56acd6caa040860d00ac94a2","category":{"_id":"56acd93a13ac890d001c3c82","__v":4,"pages":["56acdb1c13ac890d001c3c83","56ace30c5ac4060d00278664","56ace4611c09150d00a18379","56acebfb13ac890d001c3c8a"],"project":"56acd71213ac890d001c3c7a","version":"56acd71213ac890d001c3c7d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-30T15:39:38.798Z","from_sync":false,"order":1,"slug":"authorization","title":"Authorization"},"version":{"_id":"56acd71213ac890d001c3c7d","project":"56acd71213ac890d001c3c7a","__v":15,"createdAt":"2016-01-30T15:30:26.928Z","releaseDate":"2016-01-30T15:30:26.928Z","categories":["56acd71313ac890d001c3c7e","56acd8f113ac890d001c3c81","56acd8f95ac4060d0027865e","56acd93a13ac890d001c3c82","56ad20660ab3c00d00ce3347","56ad356a2a7860170013f714","56ad47eb0ab3c00d00ce334f","56afd523bc304a0d00ace1df","56b29a019621f20d00efb37e","56b657e11bc6970d009feee7","5845cc3c39950c1b002afe77","5845cde163c11b250037967e","5846efd45d064323007b17b4","588604da4674e32300efd160","588627882393d50f00f1322c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"githubsync":"","parentDoc":null,"project":"56acd71213ac890d001c3c7a","__v":17,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-30T15:47:40.312Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Quick Start\"\n}\n[/block]\n1. Signup for [GameWisp](https://gamewisp.com) and create a channel. \n2. Go to the Application Integrations page found in the Configuration menu on your Channel Dashboard.\n3. Register your application by providing the name of your application and a redirect URL that will process information from GameWisp.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"You Must Create a GameWisp Channel to Register an Application\",\n  \"body\": \"Don't forget, you need a GameWisp channel before you can successfully register an application on GameWisp. There is, however, no need to set up a detailed channel with tiers, benefits, etc.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Registering your Application\"\n}\n[/block]\nRegistering your application entails generating client credentials. First create a channel on GameWisp. There is no need to setup a full GameWisp campaign (e.g., with tiers, benefits, etc.), but the channel must exist before client credentials can be generated. \n\nOnce a channel is created, you can generate client credentials by visiting your channel dashboard ([https://gamewisp.com](https://gamewisp.com) as a logged in user), clicking on Configuration from the subnav menu\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ZvECd3i0QhC7RVGifsfC_configurationmenu.png\",\n        \"configurationmenu.png\",\n        \"1891\",\n        \"144\",\n        \"#b34d51\",\n        \"\"\n      ],\n      \"border\": true,\n      \"sizing\": \"smart\",\n      \"caption\": \"The subnav menu with the \\\"Configuration\\\" link called out in red.\"\n    }\n  ]\n}\n[/block]\nthen selecting Application Integrations from the menu that appears\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/82UVlcetT4iI9YgjZ3Y8_app_integrations_menu.png\",\n        \"app_integrations_menu.png\",\n        \"1900\",\n        \"952\",\n        \"#f46766\",\n        \"\"\n      ],\n      \"caption\": \"The Configuration menu, with the Application Integrations link called out in red.\",\n      \"border\": true\n    }\n  ]\n}\n[/block]\nOnce on the Application Integrations page you can use the \"Developer Integration\" section to create a Client ID and Client Secret. You will need to provide the Client Name and a Redirect URL. The Redirect URL will handle receiving the authorization code from GameWisp and requesting an access token. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/jVviNS2uTKWvBvUN3XAx_developer_integration_well.png\",\n        \"developer_integration_well.png\",\n        \"1230\",\n        \"472\",\n        \"#814b50\",\n        \"\"\n      ],\n      \"border\": true,\n      \"caption\": \"You can generate client credentials by providing an application name and redirect url.\"\n    }\n  ]\n}\n[/block]\nUpon clicking the \"Generate Application\" button, your client credentials will be displayed. In addition to the client ID, you will also be presented with a client secret. Store this secret immediately, it will not be displayed again once the page is reloaded. \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Store and Protect your Client Secret!\",\n  \"body\": \"Client secrets are only shown upon clicking the \\\"Generate Application\\\" button, so be sure to store the secret somewhere immediately! If you lose or need to regenerate the secret, you can click the \\\"New Secret\\\" button later.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What Next?\"\n}\n[/block]\nCheck out the [Connecting to a GameWisp Channel](https://gamewisp.readme.io/docs/connecting-to-a-gamewisp-channel) page to find out how to get access to GameWisp channel  and user data.","excerpt":"The basics of authorizing your application and gaining access to GameWisp channel data.","slug":"api-authorization","type":"basic","title":"Registering an Application"}

Registering an Application

The basics of authorizing your application and gaining access to GameWisp channel data.

[block:api-header] { "type": "basic", "title": "Quick Start" } [/block] 1. Signup for [GameWisp](https://gamewisp.com) and create a channel. 2. Go to the Application Integrations page found in the Configuration menu on your Channel Dashboard. 3. Register your application by providing the name of your application and a redirect URL that will process information from GameWisp. [block:callout] { "type": "info", "title": "You Must Create a GameWisp Channel to Register an Application", "body": "Don't forget, you need a GameWisp channel before you can successfully register an application on GameWisp. There is, however, no need to set up a detailed channel with tiers, benefits, etc." } [/block] [block:api-header] { "type": "basic", "title": "Registering your Application" } [/block] Registering your application entails generating client credentials. First create a channel on GameWisp. There is no need to setup a full GameWisp campaign (e.g., with tiers, benefits, etc.), but the channel must exist before client credentials can be generated. Once a channel is created, you can generate client credentials by visiting your channel dashboard ([https://gamewisp.com](https://gamewisp.com) as a logged in user), clicking on Configuration from the subnav menu [block:image] { "images": [ { "image": [ "https://files.readme.io/ZvECd3i0QhC7RVGifsfC_configurationmenu.png", "configurationmenu.png", "1891", "144", "#b34d51", "" ], "border": true, "sizing": "smart", "caption": "The subnav menu with the \"Configuration\" link called out in red." } ] } [/block] then selecting Application Integrations from the menu that appears [block:image] { "images": [ { "image": [ "https://files.readme.io/82UVlcetT4iI9YgjZ3Y8_app_integrations_menu.png", "app_integrations_menu.png", "1900", "952", "#f46766", "" ], "caption": "The Configuration menu, with the Application Integrations link called out in red.", "border": true } ] } [/block] Once on the Application Integrations page you can use the "Developer Integration" section to create a Client ID and Client Secret. You will need to provide the Client Name and a Redirect URL. The Redirect URL will handle receiving the authorization code from GameWisp and requesting an access token. [block:image] { "images": [ { "image": [ "https://files.readme.io/jVviNS2uTKWvBvUN3XAx_developer_integration_well.png", "developer_integration_well.png", "1230", "472", "#814b50", "" ], "border": true, "caption": "You can generate client credentials by providing an application name and redirect url." } ] } [/block] Upon clicking the "Generate Application" button, your client credentials will be displayed. In addition to the client ID, you will also be presented with a client secret. Store this secret immediately, it will not be displayed again once the page is reloaded. [block:callout] { "type": "warning", "title": "Store and Protect your Client Secret!", "body": "Client secrets are only shown upon clicking the \"Generate Application\" button, so be sure to store the secret somewhere immediately! If you lose or need to regenerate the secret, you can click the \"New Secret\" button later." } [/block] [block:api-header] { "type": "basic", "title": "What Next?" } [/block] Check out the [Connecting to a GameWisp Channel](https://gamewisp.readme.io/docs/connecting-to-a-gamewisp-channel) page to find out how to get access to GameWisp channel and user data.