From 7bc965fadac23bf9833eb34a4bb124af4e6b5cad Mon Sep 17 00:00:00 2001
From: Logan Wright <lwright.js@gmail.com>
Date: Wed, 12 Jun 2019 08:56:01 -0500
Subject: [PATCH 1/2] adds api error handling documentation

---
 docs/patterns/errorpages.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/patterns/errorpages.rst b/docs/patterns/errorpages.rst
index 1df9c061..31805171 100644
--- a/docs/patterns/errorpages.rst
+++ b/docs/patterns/errorpages.rst
@@ -97,3 +97,30 @@ An example template might be this:
       <p>What you were looking for is just not there.
       <p><a href="{{ url_for('index') }}">go somewhere nice</a>
     {% endblock %}
+
+
+Handling API Errors with Abort
+------------------------------
+
+When using Flask for web APIs, handling errors is as simple as the previous examples but with minor changes.
+
+Register the error handler::
+
+    from flask import jsonify
+
+    @app.errorhandler(404)
+    def resource_not_found(e):
+        # if passing in an Exception object directly, you may need to convert it to a string
+        return jsonify(error=str(e)), 404
+
+To use this error handler::
+
+    @app.route('/cheese', methods=['GET'])
+    def get_one_cheese():
+        # logic to find your resource
+        if (resource is None):
+            abort(404, 'Resource not found')
+        else:
+            return jsonify(resource=resource)
+
+In the above example, the error handler is invoked with the second argument passed to it. It returns the json message with the response.
\ No newline at end of file

From 4b519f0e332c8f71ea40d2272e7769321462cf47 Mon Sep 17 00:00:00 2001
From: David Lord <davidism@gmail.com>
Date: Wed, 12 Jun 2019 11:02:53 -0700
Subject: [PATCH 2/2] reword api error section

---
 docs/patterns/errorpages.rst | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/docs/patterns/errorpages.rst b/docs/patterns/errorpages.rst
index 31805171..7e43674c 100644
--- a/docs/patterns/errorpages.rst
+++ b/docs/patterns/errorpages.rst
@@ -99,28 +99,27 @@ An example template might be this:
     {% endblock %}
 
 
-Handling API Errors with Abort
-------------------------------
+Returning API errors as JSON
+----------------------------
 
-When using Flask for web APIs, handling errors is as simple as the previous examples but with minor changes.
+When using Flask for web APIs, you can use the same techniques as above
+to return JSON responses to API errors.  :func:`~flask.abort` is called
+with a ``description`` parameter. The :meth:`~flask.errorhandler` will
+use that as the JSON error message, and set the status code to 404.
 
-Register the error handler::
+.. code-block:: python
 
-    from flask import jsonify
+    from flask import abort, jsonify
 
     @app.errorhandler(404)
     def resource_not_found(e):
-        # if passing in an Exception object directly, you may need to convert it to a string
         return jsonify(error=str(e)), 404
 
-To use this error handler::
-
-    @app.route('/cheese', methods=['GET'])
+    @app.route("/cheese")
     def get_one_cheese():
-        # logic to find your resource
-        if (resource is None):
-            abort(404, 'Resource not found')
-        else:
-            return jsonify(resource=resource)
+        resource = get_resource()
 
-In the above example, the error handler is invoked with the second argument passed to it. It returns the json message with the response.
\ No newline at end of file
+        if resource is None:
+            abort(404, description="Resource not found")
+
+        return jsonify(resource)