Skip to content

Commit 759c75c

Browse files
committed
updates to Coding 101 lab
1 parent a5bdd20 commit 759c75c

File tree

11 files changed

+39
-6
lines changed

11 files changed

+39
-6
lines changed

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11

2-
# Coding 101: REST API Basics #
2+
# Coding 101 - REST API Basics #
33

44
In this Learning Lab you will learn the basics of consuming a REST API, and how to use POSTMAN to explore a REST API.
55

@@ -39,5 +39,12 @@ We are going to use the APIC-EM API as an example of a REST API in this lab. So
3939
![](/posts/files/coding-101-rest-basics-ga/assets/images/Menu.png)
4040
<br/><br/>
4141

42-
3. You are now at the APIC-EM web portal. Open the API reference doc in a separate tab while you are working on this lab.<br/>
42+
3. You are now at the APIC-EM web portal. Click on the `Docs` link.<br/>
43+
![](/posts/files/coding-101-rest-basics-ga/assets/images/apic-em-main.png)
44+
45+
4. At the APIC-EM Documentation web page open the API Reference doc in a separate tab while you are working on this lab.
4346
![](/posts/files/coding-101-rest-basics-ga/assets/images/Ref.png)
47+
<br/>
48+
<br/>
49+
50+
### Next Step: Learn about the REST Web Service

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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,3 +39,8 @@ REST is centered around the HTTP request and response model. Consuming an API i
3939
In this example, we request the list of hosts, and that information is returned to us in the response. The data returned in the response is usually json or xml.
4040

4141
(<a href="http://www.json.org/" target="_blank">JSON</a> -- JavaScript Object Notation, is a lightweight text-based open standard designed for human-readable data interchange.)
42+
43+
<br/>
44+
<br/>
45+
46+
### Next Step: HTTP Response Request Facts

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,3 +80,7 @@ The API Reference includes information data attributes to be sent and returned.
8080

8181
### Things to Try
8282
* Check out the other ticket APIs in the API Reference Guide. How do they differ from one another?
83+
<br/>
84+
<br/>
85+
86+
### Next Step: Make HTTP calls Using REST

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

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ We need to know how to construct the request to retrieve the service ticket, so
1212
* Authentication
1313
* Body
1414

15-
All of the urls for API-EM begin with:
15+
All of the urls for APIC-EM begin with:
1616

1717
```http
1818
@@ -22,7 +22,6 @@ https://{APIC-EM-Server}/api/v1
2222

2323
Let's look at the description of the ticket API call from the -- <a href="http://devnetapic.cisco.com" target="_blank">APIC-EM API Docs</a>.
2424

25-
2625
`POST /api/v1/ticket`: This method is used to create a new user ticket
2726

2827

@@ -47,3 +46,7 @@ To get the service ticket our request will look like this:
4746
* The username and password used to log into the APIC-EM Controller must be provided in JSON format in the body.
4847

4948
![](/posts/files/coding-101-rest-basics-ga/assets/images/apic-em-request.png)
49+
<br/>
50+
<br/>
51+
52+
### Next Step: Making a REST API Call

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,3 +50,7 @@ You may need to accept the SSL certificate before calling the APIs in Postman.
5050
![](/posts/files/coding-101-rest-basics-ga/assets/images/postman3.png "Response")
5151

5252
#### Congrats! You just made your first REST API call! ####
53+
<br/>
54+
<br/>
55+
56+
### Next Step: APIC-EM Hosts API URL

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ We need to know how to construct the request to retrieve the list of Hosts. So
1212
* Authentication
1313
* Body
1414

15-
As specified earlier from the API EM docs, we can see that all of the urls for API-EM begin with:
15+
As specified earlier from the APIC-EM docs, we can see that all of the urls for APIC-EM begin with:
1616

1717
```http
1818
@@ -51,3 +51,7 @@ To get the entire list of Hosts, our request will be like this:
5151
* Not required for this request
5252

5353
![](/posts/files/coding-101-rest-basics-ga/assets/images/apic-emHostRequest.png "Get Hosts")
54+
<br/>
55+
<br/>
56+
57+
### Next Step: Get Network Hosts

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,3 +29,7 @@
2929
<br/><br/>
3030

3131
#### Congrats! You just made your first REST API call using the APIC-EM Service Ticket! ####
32+
<br/>
33+
<br/>
34+
35+
### Next Step: Get Network Devices

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,3 +32,5 @@ The output will look similar to below. For display purposes some records have b
3232
* In Postman append to '/1/2' to the call http://{APIC-EMController}/api/v1/network-device so reads as 'http://{APIC-EMController}/api/v1/network-device/1/2' . Click the 'Send' button. How does the output differ?
3333
* Compare the change you just made in Get Network Devices API call versus the change you made in the Get Hosts call in the previous exercise of Step 7. How are they different and why? Hint: Check the API Reference Guide for each of these API calls.
3434
* In Postman change the API call 'http://{APIC-EMController}/api/v1/network-device/1/2' to 'http://{APIC-EMController}/api/v1/user'. Press the 'Send' button. How is the returned data different and what does it represent? Hint: Check the API Reference Guide
35+
36+
### Congrats! You've just completed lab Coding 101 - REST API Basics!
Loading
Loading

0 commit comments

Comments
 (0)