Сделал шпаргалку по структуре HTTP-запроса:

Что где может находиться и что куда помещать при проектировании API?

Куда положить версию API? Как сконструировать путь? Какие предусмотреть параметры запроса? Для чего использовать заголовки?

Вопросы спорные, потому что в разных API и стайл-гайдах их решают очень по-разному, и единства мнений нет (а есть, наоборот, священные войны за то, как правильно и что соответствует RESTу!)

В любом случае — все эти вопросы должны быть поставлены, по ним приняты решения и всё это внесено в документацию к API!