[Mailman-Developers] REST API first pass at Swagger spec

[Andrew Stuart]

Attached is a first pass at a Swagger spec for the REST API.

You can find out about Swagger at http://swagger.io

The Swagger spec that I am working on is attached to this message or can be found here: http://www.mailripper.com/api-docs.json

If you want to see the attached spec in action against the Mailman REST API, go to http://www.mailripper.com/swagger-ui/index.html

Give it a try at http://www.mailripper.com/swagger-ui/index.html - you are welcome to change anything, it’s a test Mailman server and you can add or delete anything - nothing you do will be a problem.

There’s still a fair bit to do to finalise this but most of the API queries are working - enough for you to see how it works.

Any comments or feedback welcome.

as


-------------- next part --------------
A non-text attachment was scrubbed...
Name: api-docs.json
Type: application/json
Size: 64793 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/mailman-developers/attachments/20150111/d1afaa9d/attachment-0001.json>