Какой лучший способ разметки методов/URL-адресов для веб-службы RESTful с использованием ReST/Sphinx? Существует ли домен по умолчанию, подходящий для разметки URL-адресов с их возможными параметрами, методами HTTP, заголовками и содержимым тела?
Что-то по строкам:
.. rest:method:: GET /api/foo
:param bar: A valid bar
:extension: json or xml
Retrieve foos for the given parameters. E.g.::
GET /api/foo.json?bar=baz
Что-то вроде этого уже существует или является одним из используемых по умолчанию расширений, или я должен сам написать его?