{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"PHP","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Authorization Code Redirect","type":"text"}]},{"type":"codeBlock","attrs":{"language":"php"},"content":[{"text":" //We redirect the user to the Authorization Server to authorize access\n $authorization_url = 'https://access.active911.com/interface/open_api/authorize_agency.php';\t\n\n //Set the GET parameters and then redirect the user to the authorization url\n $query_array = array(\n 'client_id' => '',\n 'response_type' => 'code',\n 'redirection_uri' => '',\n 'scope' => ''\n );\n header('Location: ' . $authorization_url . '?' . http_build_query($query_array));\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Authorization Code Exchange for Access Token and Refresh Token","type":"text"}]},{"type":"codeBlock","attrs":{"language":"php"},"content":[{"text":"//We have been redirected back here after being authorized by the Authorization Server\n//Now we need to exchange our authorization code for an access token and refresh token\n$token_url = 'https://access.active911.com/interface/open_api/token.php';\n\n//Note that we send the secret to authenticate our request. We did not send the secret to generate an authorization code because then the user would be able to see it.\n//We must send the secret from a server or protected native app, where it cannot be grabbed by the user.\n$post_array = array(\n 'client_id' => '',\n 'client_secret' => '',\n 'grant_type' => 'authorization_code',\n 'scope' => '',\n 'code' => $_GET['code']\n);\n\n//Now we have the authorization code. We send a request to the token endpoint\n$ch = curl_init();\ncurl_setopt($ch, CURLOPT_URL, $token_url); \ncurl_setopt($ch, CURLOPT_POST, 1);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_array)); \ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); \ncurl_setopt($ch, CURLOPT_VERBOSE, true);\n$output = curl_exec($ch);\n$response_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close ($ch);\n$json = json_decode($output);\n\n//Check if we got a OK response\nif($response_code != 200){\n //There was an error. Show to the user if JSON error was sent\n if(empty($json->error_description)){\n die(\"Error: Could not generate token\");\n }\n else{\n die(\"Error: \" . $json->error_description);\n }\n}\n$access_token = $json->access_token;\n$refresh_token = $json->refresh_token;\n$expiration = time() + $json->expires_in;\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Use Refresh Token to get a new Access Token","type":"text"}]},{"type":"codeBlock","attrs":{"language":"php"},"content":[{"text":" //Our access token expired. Request a new one using the refresh token.\n $token_url = 'https://access.active911.com/interface/open_api/token.php';\n\n //Note that we send the secret again to authenticate our request.\n $post_array = array(\n 'client_id' => '',\n 'client_secret' => '',\n 'grant_type' => 'refresh_token',\n 'scope' => '',\n 'refresh_token' => ''\n );\n $ch = curl_init();\n curl_setopt($ch, CURLOPT_URL, $token_url); \n curl_setopt($ch, CURLOPT_POST, 1);\n curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_array)); \n curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); \n curl_setopt($ch, CURLOPT_VERBOSE, true);\n $output = curl_exec($ch);\n $response_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n curl_close ($ch);\n $json = json_decode($output);\n \n //Check if we got a OK response\n if($response_code != 200){\n //There was an error. Show to the user if JSON error was sent\n if(empty($json->error_description)){\n die(\"Error: Could not generate token\");\n }\n else{\n die(\"Error: \" . $json->error_description);\n }\n }\n \n //Set the access token and expiration in the cookies\n $access_token = $json->access_token;\n $expiration = time() + $json->expires_in;\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"JavaScript","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"jQuery AJAX to the API using previously generated access_token","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"var access_token = \"\";\nvar base_api_uri = 'https://access.active911.com/interface/open_api/api/';\n$.ajax({\n type: \"GET\",\n url: base_api_uri,\n beforeSend: function (xhr) {\n xhr.setRequestHeader('Authorization', \"Bearer \" + access_token);\n },\n success: function (response) {\n if(response.result=='success'){\n //We successfully fetched the agency's information\n var name = response.message.agency.name;\n var latitude = response.message.agency.latitude;\n var longitude = response.message.agency.longitude;\n //Store the uri's for all of this agency's devices\n $( response.message.agency.devices ).each(function(i, device){\n devices[device.id] = {uri: device.uri};\n });\n \n \n }\n else{\n alert('Could not connect to the API');\n }\n },\n dataType: 'json'\n});\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Java","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Authorization Code Redirect w/JavaFX","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javafx"},"content":[{"text":"//We use JavaFX to show the user the Active911 website so that they can authorize the request\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport java.net.URLEncoder;\nimport java.util.HashMap;\nimport java.util.Map;\nimport javafx.application.Application;\nimport javafx.beans.value.ChangeListener;\nimport javafx.beans.value.ObservableValue;\nimport javafx.scene.Scene;\nimport javafx.scene.layout.StackPane;\nimport javafx.scene.web.WebEngine;\nimport javafx.scene.web.WebView;\nimport javafx.stage.Stage;\n\npublic class TestWebView extends Application {\n\n private String auth_code;\n\n public static void main(String[] args) {\n Application.launch(args);\n }\n\n @Override\n public void start(final Stage primaryStage) throws Exception {\n primaryStage.setTitle(\"Active911 Connect\");\n\n //Lets compose the url\n //We send the user to the Authorization Server to authorize access\n String authorization_url = \"https://access.active911.com/interface/open_api/authorize_agency.php\"; \n final String redirection_uri = \"\";\n String client_id = \"\";\n String scope = \"\";\n\n //Set the GET parameters and then send the user to the authorization url\n authorization_url +=\n \"?client_id=\" + client_id\n \"&response_type=code\" +\n \"&redirection_uri=\" + URLEncoder.encode(redirection_uri, \"UTF-8\") + \n \"&scope=\" + scope;\n\n //Show the user a browser window with the authorization endpoint\n WebView browser = new WebView();\n WebEngine engine = browser.getEngine();\n engine.load(authorization_url);\n StackPane sp = new StackPane();\n sp.getChildren().add(browser);\n Scene root = new Scene(sp);\n primaryStage.setScene(root);\n primaryStage.show();\n\n //Intercept any location that includes the authorization code\n engine.locationProperty().addListener(new ChangeListener() {\n @Override public void changed(ObservableValue ov, final String oldLoc, final String loc) {\n System.out.println(\"Saw location changed to \" + loc);\n\n //We have been redirected with our authorization code\n if (loc.contains(\"code=\")) {\n try {\n URL url = new URL(loc);\n String[] params = url.getQuery().split(\"&\");\n Map map = new HashMap();\n for (String param : params) {\n String name = param.split(\"=\")[0];\n String value = param.split(\"=\")[1];\n map.put(name, value);\n }\n System.out.println(\"The code is: \"+map.get(\"code\"));\n auth_code = map.get(\"code\");\n } catch (MalformedURLException e) {\n e.printStackTrace();\n }\n }\n }\n });\n }\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GET request to the API using previously generated access_token using the ","type":"text"},{"text":"Apache HttpComponents_Client","type":"text","marks":[{"type":"link","attrs":{"href":"https://web.archive.org/web/20200616211625/https://hc.apache.org/index.html"}}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"CloseableHttpClient httpclient = HttpClients.createDefault();\nHttpGet httpget = new HttpGet(\"https://access.active911.com/interface/open_api/api/\");\nhttpget.setHeader(\"Authorization\", \"Bearer \" + accessToken);\n\nHttpResponse response = httpclient.execute(httpget);\nHttpEntity entity = response.getEntity();","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported