Как вы документируете REST API? Не только документация о том, что ресурсы, но на самом деле, какие данные отправляются в запросе и какие данные отправляются обратно в ответ. Не достаточно полезно знать, что что-то ожидает отправки XML и возвращает XML; или JASN; или что угодно. Как вы документируете данные, которые отправляются в запросе, и данные, отправляемые обратно в ответе?

Лучшее, что я смог найти, - это инструмент Enunciate, где вы можете документировать свой REST API и элементы данных. Является ли Enunciate подходящим типом инструмента для этого, и я упускаю какие-либо другие инструменты, которые предлагают это, на что мне следует обратить внимание?

Потребителями моего REST API могут быть языки Python, Java, .NET и т. Д.