Python REST API Framework

Powered by Flask, MongoDB, Redis and good intentions Eve allows to effortlessly build and deploy highly customizable, fully featured RESTful Web Services

Eve is Simple

from eve import Eve

app = Eve()
app.run()

The API is now live, ready to be consumed:

$ curl -i http://example.com/people
HTTP/1.1 200 OK

All you need to bring your API online is a database, a configuration file (defaults to settings.py) and a launch script. Overall, you will find that configuring and fine-tuning your API is a very simple process.

Eve is thoroughly tested under Python 2.6, 2.7, 3.3, 3.4 and PyPy.

Live demo

Check out the live demo. If using a browser you will get XML back. For JSON in the browser, you might want to install Postman or similar extension and then set the Accept request header to application/json. If you are a CLI user (and you should), curl is your friend. The source code will show you how easy it is to run an API with Eve. You will also find usage examples for all common use cases (GET, POST, PATCH, DELETE and more). There is also a simple client app available.

Development Version

If you are on python-eve.org then you are looking at the documentation of the development version. Looking for last release docs? Follow this link.

User’s Guide

Developer’s Guide

A proper developer guide will be available when 1.0 is released

Support, Updates and Licensing

Changelog

Note

This documentation is under development. Please refer to the links on the sidebar for more information, or to get in touch with the development team (that being me).

https://secure.travis-ci.org/nicolaiarocci/eve.png?branch=master

Navigation

You are looking at the documentation of the development version.

Useful Links

Receive updates on new releases and upcoming projects.

Subscribe to Newsletter

Donate

Consider supporting the authors on Gittip:

Artwork by Kalamun © 2013

Fork me on GitHub