Skip to content

Commit badd5de

Browse files
mattmakaimattmakai
committed
removing duplicate api creation resource. reordering as wellg
1 parent a0bcb96 commit badd5de

4 files changed

Lines changed: 82 additions & 88 deletions

File tree

‎all.html‎

Lines changed: 29 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3905,23 +3905,6 @@ <h2>Hosted API testing services</h2>
39053905
<h2>API creation resources</h2>
39063906
<ul>
39073907
<li>
3908-
<p><a href="http://pydanny.com/choosing-an-api-framework-for-django.html">Choosing an API framework for Django</a>
3909-
by <a href="https://twitter.com/pydanny">PyDanny</a> contains questions and insight
3910-
into what makes a good API framework and which one you should currently
3911-
choose for Django.</p>
3912-
</li>
3913-
<li>
3914-
<p><a href="https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/">Create a REST API in Minutes with Pyramid and Ramses</a>
3915-
is a thorough tutorial from start to finish that uses the
3916-
<a href="/pyramid.html">Pyramid</a> web framework along with
3917-
<a href="https://pypi.python.org/pypi/ramses/">Ramses</a>, a library that uses
3918-
YAML files to generate a RESTful API.</p>
3919-
</li>
3920-
<li>
3921-
<p><a href="http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions">RESTful web services with Python</a>
3922-
is an interesting overview of the Python API frameworks space.</p>
3923-
</li>
3924-
<li>
39253908
<p><a href="https://rocketeer.be/blog/2015/03/api-quality/">An API is only as good as its documentation</a>
39263909
is a strongly held mantra in the web API world because so many APIs have
39273910
poor documentation that prevents ease-of-use. If an API is not well
@@ -3945,15 +3928,6 @@ <h2>API creation resources</h2>
39453928
developers confused about what is appropriate for RESTful APIs.</p>
39463929
</li>
39473930
<li>
3948-
<p><a href="http://blog.luisrei.com/articles/flaskrest.html">Implementing a RESTful Web API with Python &amp; Flask</a>
3949-
is a straightforward introduction to using Flask to create request
3950-
handling and responses to produce a web API.</p>
3951-
</li>
3952-
<li>
3953-
<p>This <a href="https://github.com/interagent/http-api-design">API Design Guide</a>
3954-
is based on Heroku's best practices for the platform's API.</p>
3955-
</li>
3956-
<li>
39573931
<p><a href="https://18f.gsa.gov/">18F</a>'s
39583932
<a href="https://github.com/18f/api-standards">API standards</a> explains the details
39593933
behind their design decisions on creating modern RESTful APIs.</p>
@@ -4002,6 +3976,35 @@ <h2>API creation resources</h2>
40023976
and why those choices were made.</p>
40033977
</li>
40043978
<li>
3979+
<p><a href="https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/">How many status codes does your API need?</a>
3980+
gives an answer from a Dropbox API developer as to their decision making
3981+
process.</p>
3982+
</li>
3983+
<li>
3984+
<p>This <a href="https://github.com/interagent/http-api-design">API Design Guide</a>
3985+
is based on Heroku's best practices for the platform's API.</p>
3986+
</li>
3987+
</ul>
3988+
<h2>Python-specific API creation resources</h2>
3989+
<ul>
3990+
<li>
3991+
<p><a href="http://pydanny.com/choosing-an-api-framework-for-django.html">Choosing an API framework for Django</a>
3992+
by <a href="https://twitter.com/pydanny">PyDanny</a> contains questions and insight
3993+
into what makes a good API framework and which one you should currently
3994+
choose for Django.</p>
3995+
</li>
3996+
<li>
3997+
<p><a href="https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/">Create a REST API in Minutes with Pyramid and Ramses</a>
3998+
is a thorough tutorial from start to finish that uses the
3999+
<a href="/pyramid.html">Pyramid</a> web framework along with
4000+
<a href="https://pypi.python.org/pypi/ramses/">Ramses</a>, a library that uses
4001+
YAML files to generate a RESTful API.</p>
4002+
</li>
4003+
<li>
4004+
<p><a href="http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions">RESTful web services with Python</a>
4005+
is an interesting overview of the Python API frameworks space.</p>
4006+
</li>
4007+
<li>
40054008
<p><a href="http://blog.luisrei.com/articles/flaskrest.html">Implementing a RESTful Web API with Python &amp; Flask</a>
40064009
is a good walkthrough for coding a Flask app that provides standard
40074010
web API functionality such as proper HTTP responses, authentication
@@ -4014,11 +4017,6 @@ <h2>API creation resources</h2>
40144017
subscribing to updates via a REST interface. Both REST hooks and webhooks
40154018
are far more efficient than polling for updates and notifications.</p>
40164019
</li>
4017-
<li>
4018-
<p><a href="https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/">How many status codes does your API need?</a>
4019-
gives an answer from a Dropbox API developer as to their decision making
4020-
process.</p>
4021-
</li>
40224020
</ul>
40234021
<h2>API creation learning checklist</h2>
40244022
<ol>

‎api-creation.html‎

Lines changed: 29 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -104,23 +104,6 @@ <h2>Hosted API testing services</h2>
104104
<h2>API creation resources</h2>
105105
<ul>
106106
<li>
107-
<p><a href="http://pydanny.com/choosing-an-api-framework-for-django.html">Choosing an API framework for Django</a>
108-
by <a href="https://twitter.com/pydanny">PyDanny</a> contains questions and insight
109-
into what makes a good API framework and which one you should currently
110-
choose for Django.</p>
111-
</li>
112-
<li>
113-
<p><a href="https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/">Create a REST API in Minutes with Pyramid and Ramses</a>
114-
is a thorough tutorial from start to finish that uses the
115-
<a href="/pyramid.html">Pyramid</a> web framework along with
116-
<a href="https://pypi.python.org/pypi/ramses/">Ramses</a>, a library that uses
117-
YAML files to generate a RESTful API.</p>
118-
</li>
119-
<li>
120-
<p><a href="http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions">RESTful web services with Python</a>
121-
is an interesting overview of the Python API frameworks space.</p>
122-
</li>
123-
<li>
124107
<p><a href="https://rocketeer.be/blog/2015/03/api-quality/">An API is only as good as its documentation</a>
125108
is a strongly held mantra in the web API world because so many APIs have
126109
poor documentation that prevents ease-of-use. If an API is not well
@@ -144,15 +127,6 @@ <h2>API creation resources</h2>
144127
developers confused about what is appropriate for RESTful APIs.</p>
145128
</li>
146129
<li>
147-
<p><a href="http://blog.luisrei.com/articles/flaskrest.html">Implementing a RESTful Web API with Python &amp; Flask</a>
148-
is a straightforward introduction to using Flask to create request
149-
handling and responses to produce a web API.</p>
150-
</li>
151-
<li>
152-
<p>This <a href="https://github.com/interagent/http-api-design">API Design Guide</a>
153-
is based on Heroku's best practices for the platform's API.</p>
154-
</li>
155-
<li>
156130
<p><a href="https://18f.gsa.gov/">18F</a>'s
157131
<a href="https://github.com/18f/api-standards">API standards</a> explains the details
158132
behind their design decisions on creating modern RESTful APIs.</p>
@@ -201,6 +175,35 @@ <h2>API creation resources</h2>
201175
and why those choices were made.</p>
202176
</li>
203177
<li>
178+
<p><a href="https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/">How many status codes does your API need?</a>
179+
gives an answer from a Dropbox API developer as to their decision making
180+
process.</p>
181+
</li>
182+
<li>
183+
<p>This <a href="https://github.com/interagent/http-api-design">API Design Guide</a>
184+
is based on Heroku's best practices for the platform's API.</p>
185+
</li>
186+
</ul>
187+
<h2>Python-specific API creation resources</h2>
188+
<ul>
189+
<li>
190+
<p><a href="http://pydanny.com/choosing-an-api-framework-for-django.html">Choosing an API framework for Django</a>
191+
by <a href="https://twitter.com/pydanny">PyDanny</a> contains questions and insight
192+
into what makes a good API framework and which one you should currently
193+
choose for Django.</p>
194+
</li>
195+
<li>
196+
<p><a href="https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/">Create a REST API in Minutes with Pyramid and Ramses</a>
197+
is a thorough tutorial from start to finish that uses the
198+
<a href="/pyramid.html">Pyramid</a> web framework along with
199+
<a href="https://pypi.python.org/pypi/ramses/">Ramses</a>, a library that uses
200+
YAML files to generate a RESTful API.</p>
201+
</li>
202+
<li>
203+
<p><a href="http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions">RESTful web services with Python</a>
204+
is an interesting overview of the Python API frameworks space.</p>
205+
</li>
206+
<li>
204207
<p><a href="http://blog.luisrei.com/articles/flaskrest.html">Implementing a RESTful Web API with Python &amp; Flask</a>
205208
is a good walkthrough for coding a Flask app that provides standard
206209
web API functionality such as proper HTTP responses, authentication
@@ -213,11 +216,6 @@ <h2>API creation resources</h2>
213216
subscribing to updates via a REST interface. Both REST hooks and webhooks
214217
are far more efficient than polling for updates and notifications.</p>
215218
</li>
216-
<li>
217-
<p><a href="https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/">How many status codes does your API need?</a>
218-
gives an answer from a Dropbox API developer as to their decision making
219-
process.</p>
220-
</li>
221219
</ul>
222220
<h2>API creation learning checklist</h2>
223221
<ol>

‎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>2015-06-27T08:21:54Z</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>2015-06-28T15:31:15Z</updated></feed>

‎source/content/pages/06-web-apis/03-api-creation.markdown‎

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -66,20 +66,6 @@ equivalent of browser testing in the web application world.
6666

6767

6868
## API creation resources
69-
* [Choosing an API framework for Django](http://pydanny.com/choosing-an-api-framework-for-django.html)
70-
by [PyDanny](https://twitter.com/pydanny) contains questions and insight
71-
into what makes a good API framework and which one you should currently
72-
choose for Django.
73-
74-
* [Create a REST API in Minutes with Pyramid and Ramses](https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/)
75-
is a thorough tutorial from start to finish that uses the
76-
[Pyramid](/pyramid.html) web framework along with
77-
[Ramses](https://pypi.python.org/pypi/ramses/), a library that uses
78-
YAML files to generate a RESTful API.
79-
80-
* [RESTful web services with Python](http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions)
81-
is an interesting overview of the Python API frameworks space.
82-
8369
* [An API is only as good as its documentation](https://rocketeer.be/blog/2015/03/api-quality/)
8470
is a strongly held mantra in the web API world because so many APIs have
8571
poor documentation that prevents ease-of-use. If an API is not well
@@ -99,13 +85,6 @@ equivalent of browser testing in the web application world.
9985
* [NARWHL](http://www.narwhl.com/) is a practical API design site for
10086
developers confused about what is appropriate for RESTful APIs.
10187

102-
* [Implementing a RESTful Web API with Python & Flask](http://blog.luisrei.com/articles/flaskrest.html)
103-
is a straightforward introduction to using Flask to create request
104-
handling and responses to produce a web API.
105-
106-
* This [API Design Guide](https://github.com/interagent/http-api-design)
107-
is based on Heroku's best practices for the platform's API.
108-
10988
* [18F](https://18f.gsa.gov/)'s
11089
[API standards](https://github.com/18f/api-standards) explains the details
11190
behind their design decisions on creating modern RESTful APIs.
@@ -145,6 +124,29 @@ equivalent of browser testing in the web application world.
145124
tells the story of design decisions that were made during an API's creation
146125
and why those choices were made.
147126

127+
* [How many status codes does your API need?](https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/)
128+
gives an answer from a Dropbox API developer as to their decision making
129+
process.
130+
131+
* This [API Design Guide](https://github.com/interagent/http-api-design)
132+
is based on Heroku's best practices for the platform's API.
133+
134+
135+
## Python-specific API creation resources
136+
* [Choosing an API framework for Django](http://pydanny.com/choosing-an-api-framework-for-django.html)
137+
by [PyDanny](https://twitter.com/pydanny) contains questions and insight
138+
into what makes a good API framework and which one you should currently
139+
choose for Django.
140+
141+
* [Create a REST API in Minutes with Pyramid and Ramses](https://realpython.com/blog/python/create-a-rest-api-in-minutes-with-pyramid-and-ramses/)
142+
is a thorough tutorial from start to finish that uses the
143+
[Pyramid](/pyramid.html) web framework along with
144+
[Ramses](https://pypi.python.org/pypi/ramses/), a library that uses
145+
YAML files to generate a RESTful API.
146+
147+
* [RESTful web services with Python](http://www.slideshare.net/Solution4Future/python-restful-webservices-with-python-flask-and-django-solutions)
148+
is an interesting overview of the Python API frameworks space.
149+
148150
* [Implementing a RESTful Web API with Python & Flask](http://blog.luisrei.com/articles/flaskrest.html)
149151
is a good walkthrough for coding a Flask app that provides standard
150152
web API functionality such as proper HTTP responses, authentication
@@ -156,10 +158,6 @@ equivalent of browser testing in the web application world.
156158
subscribing to updates via a REST interface. Both REST hooks and webhooks
157159
are far more efficient than polling for updates and notifications.
158160

159-
* [How many status codes does your API need?](https://blogs.dropbox.com/developers/2015/04/how-many-http-status-codes-should-your-api-use/)
160-
gives an answer from a Dropbox API developer as to their decision making
161-
process.
162-
163161

164162
## API creation learning checklist
165163
1. Pick an API framework appropriate for your web framework. For Django I

0 commit comments

Comments
 (0)