An example RESTful API app showcasing the power of pyramid_openapi3
This folder showcases how to use the pyramid_openapi3 Pyramid add-on for building robust RESTful APIs. With only a few lines of code you get automatic validation of requests and responses against an OpenAPI v3 schema, along with Swagger "try-it-out" documentation for your API.
How to run
$ git clone https://github.com/Pylons/pyramid_openapi3.git $ cd pyramid_openapi3/examples/todoapp $ virtualenv -p python3.7 . $ source bin/activate $ pip install pyramid_openapi3 $ python app.py
Then use the Swagger interface at http://localhost:6543/docs/ to discover the API. Use the
Try it out button to run through a few request/response scenarios.
- Get all TODO items using the GET request.
- Adding a new TODO item using the POST request.
- Getting a 400 BadRequest response for an empty POST request
- Getting a 400 BadRequest response for a POST request when
titleis too long (over 40 characters).
All of these examples are covered with tests that you can run with
$ python -m unittest tests.py.
A simpler, single-file example is available in the
A fully built-out app, with 100% test coverage, providing a RealWorld.io API is available at niteoweb/pyramid-realworld-example-app. It is a Heroku-deployable Pyramid app that provides an API for a Medium.com-like social app. You are encouraged to use it as a scaffold for your next project.
More information about the library providing the integration between OpenAPI specs and Pyramid, more advanced features and design defence, is available in the main README file.
More validators for fields are listed in the OpenAPI Specification document. You can use Regex as well.
For an idea of a fully-fledged production OpenApi specification, check out WooCart's OpenAPI docs.