Partial edits

Author: agentlecisco

.gitignore

@@ -0,0 +1 @@
+.DS_Store

labs/coding-101-rest-basics-ga/1.md

@@ -3,7 +3,7 @@
 
 This Learning Lab explains the basics of using a REST API. It also shows how to use Postman to explore a REST API.
 
-## Objective
+## Objectives
 
 * Understand REST APIs
 * Learn how to use the Postman application to make API calls
@@ -23,15 +23,15 @@ This Learning Lab explains the basics of using a REST API. It also shows how to
 A good starting point to understand any API is to look at the documentation for the API. Now, find documentation for the DNA Center API.
 
 1. In a browser, navigate to the [DevNet](https://developer.cisco.com/) home page.
-1. Use the menu at the top to navigate to the .
+1. Use the menu at the top to navigate to the DNA Center Platform page.
    * Click the **Technologies** link to see the submenu.
-   * Click **Networking**
-   * From the list of technologies, click **DNA Center Platform)**.
+   * Click **Networking**.
+   * From the list of technologies, click **DNA Center Platform**.
 ![](/posts/files/coding-101-rest-basics-ga/assets/images/Menu.png)
-    <br/>
+
 1. On the DNA Center Platform page, click the `Docs` link.
 1. Click `API Reference`.
 1. Select the latest API version.
-1. Keep the DNA Center API Reference documentation open in a separate tab. This will be a useful reference while you work on this lab.
+1. Keep the DNA Center API Reference documentation open in a separate tab. This page provides a useful reference while you work on this lab.
 
-### Next Step:  Learn about the REST Web Service
+### Next Step: Learn about the REST web service

labs/coding-101-rest-basics-ga/2.md

@@ -28,7 +28,6 @@ Using the DNA Center APIs, you can retrieve information about devices on your ne
 
 Look at the [DNA Center documentation](https://developer.cisco.com/site/dna-center-rest-api/) to see the details of the functions.
 
-
 ### How does this work?
 
 ![](/posts/files/coding-101-rest-basics-ga/assets/images/howitworks.jpg "How it Works")
@@ -37,7 +36,7 @@ REST is centered around the HTTP request and response model. Consuming an API is
 
 In this example, you request the list of hosts, and that information is returned to you in the response. The data returned in the response is usually formatted as JSON or XML.
 
-* [JSON](https://www.json.org/") - JSON, or JavaScript Object Notation, is a lightweight text-based open standard designed for human-readable data interchange.
+* [JSON](https://www.json.org/) - JSON, or JavaScript Object Notation, is a lightweight text-based open standard designed for human-readable data interchange.
 
 * [XML](https://www.w3schools.com/xml/xml_whatis.asp) - XML, or eXtensible Markup Language, a language designed to store and transport data.
 

labs/coding-101-rest-basics-ga/3.md

@@ -32,31 +32,26 @@ REST APIs have three common methods to authenticate users:
 
 * **Basic HTTP:** The username and password are passed to the server as an encoded string. For more information, see [Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication).
 * **OAuth:** Open standard for HTTP authentication and session management. Creates an access token associated with a specific user that also specifies the user rights. The token identifies the user and rights when making API calls to verify access and control. See [OAuth](https://en.wikipedia.org/wiki/OAuth) for more information.
-3. **Token:** As with OAuth, a token is created and passed with each API call, but there is no session management and tracking of clients. This simplifies interaction between the server and client. APIC-EM uses this design for authentication management. See [Token Based Authentication](https://scotch.io/tutorials/the-ins-and-outs-of-token-based-authentication) for more information.
+3. **Token:** As with OAuth, a token is created and passed with each API call, but there is no session management and tracking of clients. This simplifies interaction between the server and client. See [Token Based Authentication](https://scotch.io/tutorials/the-ins-and-outs-of-token-based-authentication) for more information.
 
-APIC-EM uses token-based authentication. So the first request you need to make creates a token. In  APIC-EM, this token is called a *token*. The controller uses the token to determine which endpoints you can access. The token must be included in every API call except the one that creates the ticket.
+APIC-EM uses token-based authentication. So the first request you need to make creates a token. In DNA Center, this string is called a *token*. The controller uses the token to determine which endpoints you can access. The token must be included in every API call.
 
-The steps for using the APIC-EM authentication token are:
+The steps for using the DNA Center authentication token are:
 
-1. Create a ticket
+1. Send a POST to the token endpoint.
 2. A ticket (token) is returned in response body.
 3. Include this token in the 'X-Auth-Token' header on all subsequent requests.
 
 ### Using the API Reference Documentation
 
-The API Reference Documentation is where you can find the list of the API methods and the details for information on how to make each request. When you are starting to work with a new API,
-the API Reference is one of the most important sources of information.
+The API Reference Documentation is where you can find the list of the API methods and the details for information on how to make each request. When you are starting to work with a new API, the API Reference is one of the most important sources of information.
 
 Study the Ticket API in APIC-EM:
 
-* Open the <a href="https://developer.cisco.com/site/apic-em/docs/api.html?version=1.6" target="_blank">APIC-EM Reference Docs</a>. Pick the proper version of API. The entire API is presented in scrollable format.
+* Open the [DNA Center API reference docs](https://developer.cisco.com/site/dna-center-rest-api/). Pick the proper version of API. The entire API is presented in scrollable format.
 
     ![](/posts/files/coding-101-rest-basics-ga/assets/images/refguide1.png)
 
-* Click **Roll Based Access Control**, then scroll down to **ticket**.
-
-* Click **'POST' /ticket**. This endpoint provides functionality to create a ticket.
-
 * The API Reference includes attributes to be sent and returned. The Response portion defines the returned data, including HTTP status codes.
 
 *  HTTP status codes indicate success, error, or other conditions. For more information, see  [https://www.w3.org/Protocols/HTTP/HTRESP.html](https://www.w3.org/Protocols/HTTP/HTRESP.html)
@@ -66,15 +61,12 @@ Study the Ticket API in APIC-EM:
 		* 401 Not Authorized
 
 
-* Review the content to see what data is expected to be sent to the server and returned to your application. Both are circled here. In the example response for the Create Ticket request, you can see that the response string contains a `serviceTicket` attribute with a value of type string. This value is the authentication token you will need to make calls to all of the other API endpoints.
+* Review the content to see what data is expected to be sent to the server and returned to your application. In the example response for the network devices request, you can see that the response string contains a `hostName` attribute with a value of type Array[string].
 
   ![](/posts/files/coding-101-rest-basics-ga/assets/images/refguide4.png)
 
-* In the Parameters section, click **Example Value**. Double-clicking the box moves the parameters to an editable box on the left to try out the function.
-
-  ![](/posts/files/coding-101-rest-basics-ga/assets/images/refguide5.png)
+### Things to try
 
-### Things to Try
-* Look at the other ticket endpoints in the API Reference Guide. How do they differ from one another?
+* Look at the other network devices endpoints in the API Reference Guide. How do they differ from one another?
 
-### Next Step: Make HTTP calls Using REST
+### Next Step: Make HTTP calls using REST

labs/coding-101-rest-basics-ga/4.md

@@ -1,6 +1,6 @@
-## Step 4. Constructing a REST Call
+## Step 4. Construct a REST Call
 
-### APIC-EM Example: POST Create a Ticket
+### DNA Center Example: POST Create a Token
 
 Now, look at how to use the API to create a token for authentication.
 
@@ -12,39 +12,28 @@ You need to know how to construct the request to retrieve the token. Use the API
 * Authentication
 * Body
 
-All of the URLs for APIC-EM begin with:
-
-```http
-
-https://{APIC-EM-Server}/api/v1
-
-```
-
-Get the description of the ticket API call from the -- <a href="https://developer.cisco.com/site/apic-em/docs/api.html?version=1.6" target="_blank">DNA Center API Docs</a>. Choose the proper API version.
-
-`POST /api/v1/ticket`: This method creates a new user ticket
+Get the description of the token API call from the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api/). Choose the proper API version.
 
+`POST /api/v1/token`: This method creates a new user token.
 
 The HTTP call to a create a token is easy.
-```http
+```
 
-https://{APIC-EM-Server}/api/v1/ticket
+POST https://{DNA-Center-Server}/api/system/v1/auth/token
 
 ```
 
 To get the token your request will look like this:
 
 * **Method** - `POST`
-* **URL** - `https://{APIC-EM-Server}/api/v1/ticket`
-	* Substitute `{APIC-EM-Server}` with the IP address or hostname of the DNA Center you are using. For example, the Cisco DevNet Learning Labs DNA Center is `https://sandboxdnac.cisco.com/`.
+* **URL** - `https://{DNA-Center-Server}/api/system/v1/auth/token`
+	* Substitute `{DNA-Center-Server}` with the IP address or hostname of the DNA Center you are using. For example, the Cisco DevNet Learning Labs DNA Center is `https://sandboxdnac.cisco.com/`.
 * **Headers**
 	* Specify the 'Content-Type' as 'application/json'. It's typical to include this header with all HTTP methods (GET, POST, PUT, DELETE) calls.
 * **Authentication**
 	* In this API call, the authentication data is passed in the body.
 * **Body**
 	 * Provide the username and password for logging into the DNA Center in JSON format.
 
-![](/posts/files/coding-101-rest-basics-ga/assets/images/apic-em-request.png)
-
 
-### Next Step: Making a REST API Call
+### Next Step: Making a REST API call

labs/coding-101-rest-basics-ga/5.md

@@ -22,14 +22,13 @@ On OS X, to use Python 3.4, you may need to accept the SSL certificate before ca
 
 4. Click the **Proceed to <your IP>** link.
 
-5. You should then be taken the login screen. Now you are ready to start working in Postman.<br/><br/>
-![](/posts/files/coding-101-rest-basics-ga/assets/images/ssl3.png)
+5. You should then be taken the login screen. Now you are ready to start working in Postman.
 
-### Using Postman to make REST API Calls
+### Use Postman to make REST API calls
 
 1. Start Chrome and open Postman. If you are on a DevNet Zone station, Postman is already installed.
 
-2. For your request to retrieve the list of hosts into the appropriate Postman fields, enter the following information:
+2. Set up your request to retrieve a token. In the Postman fields, enter the following information:
 
    ![](/posts/files/coding-101-rest-basics-ga/assets/images/postman1.png)
 
@@ -38,17 +37,21 @@ On OS X, to use Python 3.4, you may need to accept the SSL certificate before ca
 	* **URL**
 		* ``B.`` Enter `https://sandboxdnac.cisco.com/api/system/v1/auth/token` to use the DevNet Sandbox, or enter your own API endpoint.
 	* **Body**
-		* ``C.`` Enter the username and password in JSON format. These credentials are used to log into the DNA Center. If you are accessing the DNA Center Platform Sandbox, enter the username and password, as specified earlier. Otherwise, enter the required username and password for your DNA Center.
+		* ``C.`` Enter the username and password in JSON format. Use these credentials to get a token for use in the DNA Center. If you are accessing the DNA Center Platform Sandbox, enter the username and password, as specified earlier. Otherwise, enter the required username and password for your DNA Center.
 	* **Headers**
-		* ``A.`` In the header, enter: `Content-Type`  followed by `application/json`.<br/><br/>
-		![](/posts/files/coding-101-rest-basics-ga/assets/images/postman2.png)<br/><br/>
-	* **Authentication**
-		* Authentication is entered using the Body, as specified earlier.
+		* ``A.`` In the header, enter: `Content-Type`  followed by `application/json`.
 3. Click **Send**.
 4. Postman sends the request to the server and displays the response.
 	* The **Response Code**, `200`, appears in the **Status** field.
-	* The **JSON** response contains a **token** attribute. You've highlighted an example token value. The actual value will be different. **Copy and paste this value into a text file to use for the next steps!**
+	* The **JSON** response contains a **token** attribute. Here is an example token value. The actual value will be different.
 
-#### Congratulations! You made your first REST API call!
+  ```
+  {
+    "Token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI1YjE1MGMwMzY1MWY5MzAwOGFjZDEzZGIiLCJhdXRoU291cmNlIjoiaW50ZXJuYWwiLCJ0ZW5hbnROYW1lIjoiVE5UMCIsInJvbGVzIjpbIjViMTNmY2ZhNjUxZjkzMDA4YWNkMDcwOSJdLCJ0ZW5hbnRJZCI6IjViMTNmY2Y5NjUxZjkzMDA4YWNkMDcwMiIsImV4cCI6MTUyODg0MTE1OCwidXNlcm5hbWUiOiJkZXZuZXR1c2VyIn0.rK54CBNlua7AjRT7rtWIV6jzpGTNK7OUTs10t8MDGoF"
+  }
+  ```
+   **Copy and paste this value into a text file to use for the next steps!**
+
+#### Congratulations! You made a first REST API call to DNA Center!
 
 ### Next Step: Hosts API URL

labs/coding-101-rest-basics-ga/6.md

@@ -1,54 +1,47 @@
-## Step 6. Using the Service Ticket to Make APIC-EM REST API Calls
+## Step 6. Use a token to make REST API calls
 
-### APIC-EM Example: Get Hosts
+### Example: Get Hosts
 
 Now, look at the Get Hosts endpoint. A host is an end device attached to the network, such as a computer connected to a wireless device. Your goal is to find the hosts and display information about them.
 
-To construct a request that retrieves a list of hosts, refer to the <a href="https://developer.cisco.com/site/apic-em-rest-api//" target="_blank">DNA Center API Docs</a>. Click on Inventory under Services to find Get /host. These provide the following information:
+To construct a request that retrieves a list of hosts, refer to the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api/). Click on Inventory under Services to find Get /host. These provide the following information:
 
 * Method
 * URL
 * Headers
 * Authentication
 * Body
 
-As specified earlier, you can see that the base URL for APIC-EM is:
-
-```http
-
-https://{APIC-EM-Server}/api/v1
+As specified earlier, you can see that the base URL for DNA Center is:
 
+```
+https://{DNA-Center-Server}/api/v1
 ```
 
 The following call retrieves all of hosts on the specified server
-```http
-
-GET https://{APIC-EM-Server}/api/v1/host
 
+```
+GET https://{DNA-Center-Server}/api/v1/host
 ```
 
 Alternatively, you may want to retrieve some of the hosts to page through them. In that case, pass the 'limit' parameter to specify the maximum number of hosts to be returned. You can also pass the 'offset' parameter to specify where to start the list of hosts. The following call specifies to start from the first host, (offset=1), and to return a maximum of five hosts, (limit=5).
-```http
-
-GET https://{APIC-EM-Server}/api/v1/host?limit=5&offset=1
-
+```
+GET https://{DNA-Center-Server}/api/v1/host?limit=5&offset=1
 ```
 
-To get the entire list of hosts, your request will be like this:
+To get the entire list of hosts, your request contains these items:
 
 * **Method** - `GET`
-* **URL** - `https://{APIC-EM-Server}/api/v1/host`
+* **URL** - `https://{DNA-Center-Server}/api/v1/host`
 	* Insert the IP address or hostname of the DNA Center.
 * **Headers**
-	* For authentication, add the token that was created earlier. On the left side of the header, add the text 'X-Auth-Token'. On the right side, add the token value. See screenshot on next page for information on how to set this up in Postman.
-	* When using GET, a content header is not required. However, it's a good practice to specify the content in the header anyway as  'Content-Type' 'application/json'.
+	* For authentication, add the token that was created earlier. On the left side of the header, add the text 'X-Auth-Token'. On the right side, add the token value.
+	* When using GET, a content header is not required. However, it's a good practice to specify the content in the header anyway as: 'Content-Type' 'application/json'.
 * **Authentication**
 	* Handled in the header.
 * **Body**
 	 * Not required for this request.
 
-![](/posts/files/coding-101-rest-basics-ga/assets/images/apic-emHostRequest.png "Get Hosts")
-<br/>
-<br/>
+![](/posts/files/coding-101-rest-basics-ga/assets/images/HostRequest.png)
 
 ### Next Step: Get Network Hosts

labs/coding-101-rest-basics-ga/7.md

@@ -1,17 +1,17 @@
 ## Step 7. Getting the Network Hosts
 
 1. Set up the API call in Postman.
-	* Now, use the token to authorize a request to GET the hosts from the controller.<br/><br/>
-	![](/posts/files/coding-101-rest-basics-ga/assets/images/postman4.png)<br/><br/>
+	* Now, use the token to authorize a request to GET the hosts from the controller.
+	![](/posts/files/coding-101-rest-basics-ga/assets/images/postman4.png)
 
 2. Enter the following information:
 	* **Method**
-		* `A.` Select **GET** in the Method drop down
+		* `A.` Select **GET** in the Method drop down.
 	* **URL**
-		* `B.` Enter **https://sandboxdnac/api/v1/host**
+		* `B.` Enter **https://sandboxdnac.cisco.com/api/v1/host**
             * If you are not using your DNA Center, use the DNA Center Lab: https://sandboxdnac.cisco.com.
 	* **Headers**
-		* `C.` Enter the 'Content-Type' and value 'application/json'
+		* `C.` Enter the 'Content-Type' and value 'application/json'.
 		* `C.` Enter the 'X-Auth-Token' and the token created earlier. The 'X-Auth-Token' is required for all DNA Center API calls.
 	* **Authentication**
 		* Handled in the Headers

labs/coding-101-rest-basics-ga/8.md

@@ -2,7 +2,7 @@
 
 Now, look at the Get Network Devices endpoint. A Network Device transports data to/from host devices or other network devices. A network device is typically a hub, switch, or router. It can be connected to the network by an Ethernet cable or wireless connection. Your goal is to find the network devices and display information about them.
 
-For details about the Get Network Device API, consult the [DNA Center API Docs](https://developer.cisco.com/site/apic-em-rest-api//).
+For details about the Get Network Device API, consult the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api//).
 
 1. Set up the API Call in Postman. Use the token to authorize a request to GET the network devices from the controller.