We're using swagger to great effect, the ability to add markdown against the endpoints allows us to describe them with both relevant documentation and examples.

http://oi60.tinypic.com/33llco5.jpg