Я хотел бы знать, существуют ли некоторые лучшие практики о корневой конечной точке для веб-сервиса REST? Я имею в виду, это должна быть короткая документация об использовании самого API? Это должен быть XML-документ, описывающий все доступные методы? Это должно только возвратить "неизвестный метод"?
Этот вопрос неясен. Я предполагаю, что это означает что-то вроде каталога, в котором находятся все методы API. Например, корневой каталог Flickr API будет http://api.flickr.com/services/rest/ .
Для примера проекта, который обращается к Flickr API, см. python-flickrapi