Skip to content

Commit b89ff34

Browse files
mattmakaimattmakai
committed
working on api page
1 parent e33cb3a commit b89ff34

File tree

3 files changed

+31
-2
lines changed

3 files changed

+31
-2
lines changed

‎application-programming-interfaces.html‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,23 @@ <h2>Why are APIs important?</h2>
4747
webpages are not easily consumable by other machines. Numerous scraping
4848
programs and libraries exist to rip data out of HTML but it's simpler
4949
to consume data through APIs.</p>
50+
<h2>Key API concepts</h2>
51+
<p>There are several key concepts that get thrown around in the APIs world. It's
52+
best to understand these ideas first before diving into the API literature.</p>
53+
<ul>
54+
<li>
55+
<p>Representation State Transfer (REST)</p>
56+
</li>
57+
<li>
58+
<p>Webhooks</p>
59+
</li>
60+
<li>
61+
<p>JavaScript Object Notation (JSON) and Extensible Markup Language (XML)</p>
62+
</li>
63+
<li>
64+
<p>Endpoints</p>
65+
</li>
66+
</ul>
5067
<h2>Webhooks</h2>
5168
<p>A webhook is a user-defined HTTP callback to a URL that executes when a
5269
system condition is met. The call alerts the second system via a POST or GET

‎feeds/all.atom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2014-05-28T08:54:22Z</updated></feed>
2+
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2014-05-29T06:50:11Z</updated></feed>

‎source/content/pages/06-apis/0601-application-programming-interfaces.markdown‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,19 @@ programs and libraries exist to rip data out of HTML but it's simpler
2828
to consume data through APIs.
2929

3030

31+
## Key API concepts
32+
There are several key concepts that get thrown around in the APIs world. It's
33+
best to understand these ideas first before diving into the API literature.
34+
35+
* Representation State Transfer (REST)
36+
37+
* Webhooks
38+
39+
* JavaScript Object Notation (JSON) and Extensible Markup Language (XML)
40+
41+
* Endpoints
42+
43+
3144
## Webhooks
3245
A webhook is a user-defined HTTP callback to a URL that executes when a
3346
system condition is met. The call alerts the second system via a POST or GET
@@ -45,7 +58,6 @@ on the number's page on Twilio as shown below.
4558
<img src="theme/img/twilio-webhook-definition.jpg" width="100%" alt="Webhook definition in the Twilio API." class="technical-diagram" />
4659

4760

48-
4961
## API open source projects
5062
* [Swagger](https://github.com/wordnik/swagger-core) is an open source project
5163
written in Scala that defines a standard interface for RESTful APIs.

0 commit comments

Comments
 (0)